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Introduction 





The Logo programming language was originally developed at MIT in 1968 by Seymour Papert and his colleagues. It was 
initially implemented on mainframe, timeshared computer systems. Those versions did not include the familiar turtle graphics 
that are now considered an integral part of Logo. In the early 1980s, versions of Logo were created for microcomputers and 
began to appear in classrooms across the country. Since those early implementations, there have been many versions of Logo 
for many different computers. In this book, you will be learning about the version of Logo called LogoWriter. This version 
differs from earlier versions in that a word processor is an integral part of the system and the user interface has been redesigned 
so that it better matches the perceptions of novice users. That is, the human-machine interface has been modified so that many 
things that users will “naturally” do and/or assume are correct will indeed be correct. However, most of what you will learn in 
this book about the Logo programming language applies to any version of Logo. 


Overview for Teachers 


The goal of this book is to teach about programming in the Logo language. However, you need to be aware that there is 
much more to Logo than just learning to program using it. Logo encompasses a philosophy of learning best explained in 
Seymour Papert’s book Mindstorms: Children, Computers, and Powerful Ideas. You should balance your learning and/or 
teaching of Logo programming techniques with learning about and/or applying the Logo philosophy by using sources such as 
the writings of Papert. 


Problem solving has long been a component of teaching Logo. This book does not focus on specific problem- solving ideas 
except as they affect the program writing and debugging process. It seems appropriate that you include some specific teaching of 
problem solving as you work with Logo. You can find ideas for such lessons in the books Getting Smarter at Solving Problems 
and Introduction to LogoWriter: A Problem-Solving Approach. These books are available through ISTE at the address given in 
this book. 


Introduction to Programming in Logo Using LogoWriter is a textbook-like source of information about Logo syntax and 
grammar. Although it is not as technical as a reference manual, it does contain detailed explanations of most Logo primitives. 
However, it goes further in that it discusses some computer science concepts, such as programming style, modularity, and 
control structures. As a teacher of Logo or trainer of Logo teachers, you need to be comfortable enough with Logo to help your 
students debug their programs. This book is designed to help you learn Logo syntax in a rather structured manner. 


If you are a teacher of younger students, you should keep in mind, however, that this book is in no way designed to model 
the way you should teach Logo in the classroom. Your teaching should encompass the exploratory, discovery learning 
emphasized in the Logo philosophy. Most likely you will not want to teach a formal Logo lesson each day. On the other hand, if 
you are teaching older students, say in a computer science class, you may want to use a more structured approach, or perhaps 
combine the two approaches. Whatever way you teach Logo, you should be aware that there is nothing magical about the 
sequence in which topics are presented in this book. There are many appropriate paths available for learning about Logo. 


If you are interested in pursuing your study of Logo as a programming language, then you should explore the book 
Computer Science Logo Style, Volume 1 by Brian Harvey. This book, the first in a series of three books on Logo and computer 
science, is available from MIT Press in Cambridge, Massachusetts. 


Overview for Learners 


This book is designed to teach you LogoWriter in a rather structured manner. The major portion of the the book is divided 
into small chapters, each of which focuses on a particular LogoWriter word or idea. You should not simply read the chapters in 
the book but rather should try out examples that are given in the text and experiment with them until you understand the concept 
being introduced. Most chapters end with some hints to make your work with Logo easier and some ideas for “projects.” These 
project ideas are designed to give you an opportunity to experiment with the ideas you have learned and to extend your 
knowledge of LogoWriter. You should take some time to work through some of the ideas in each chapter before moving to the 
next section of the book. 

Note that the book contains a fair amount of reference material. In the appendices you will find key summaries, copies of 
the keyboard stickers that come with the LogoWriter kits, a copy of the “shapes” pages, and a “quick reference card” that 
includes a list of all LogoWriter primitives. (The word “primitive” refers to a word that LogoWriter “knows.”) You may want to 
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FORWARD 50 
RIGHT 90 
a 





Do you see that you don’t have to retype a command to use it again? Can you finish drawing the square without typing any more 
commands? 


Next type 

CG (Return/Enter) 

to clear the screen. CG stands for Clear Graphics. 
Now type 

FORWARD 


and press Return/Enter. What happens? Logo is telling you that you must put a number after FORWARD to tell the turtle how 
far forward to move. Logo usually gives you helpful messages when you make a mistake. Read them carefully. 


Below is a list of some of the commands the turtle understands: 
FORWARD number BACK number 
FD number BK number 


RIGHT number LEFT number 
RT number LT number 


PU PD 
(Pen Up) (Pen Down) 


CG 
(Clear Graphics) 





Experiment with these commands to see how each one works. Remember to press Return/Enter after each command. After you 
have experimented for a while, decide on a design or drawing to make. If you make mistakes you can use CG to clear the page 
and start again. Recall that the commands you used are still available at the bottom of your screen. Remember that this area of 
the screen is called the Command Center. 
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CREATING SHAPES USING A MACINTOSH 


Go to the Shapes Page by selecting “Shapes...” from the Edit menu or by typing SHAPES in the Command Center. Your 
screen will look something like this: 


& File Edit Search Font Utilities 


13 19 20 


BO<votRi rg 


22 23 24 25 26 27 28 29 30 


we Se B Wa oe TA ll 


31 32 33 34 35 36 37 38 39 40 


© Cx«) © 





On the left side of the screen you see the available shapes. Clicking on a shape causes an enlargement of that shape to 
appear in the box on the right side of the screen. Below the box on the right side of the screen is a menu you can use to edit 
shapes. Each box gives you a different editing tool: 


Flip horizontal 


: Inverse video 





Go back to shape number 1. Spend some time exploring the shape editing box. How many “blocks” across is the shape? 
How many “blocks” up and down is it? How does each editing tool work? You can print the Shape Editor page using 9€-P or 
the File Menu. 
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MAKING YOUR OWN SHAPE 


Next, press the space bar or click the mouse in the square shape window. If you are on a “colored in” block, it disappears. 
If you are not on a block, a block appears. 

See if you can make one of your initials to replace the dot in shape number 1. If you are using IBM or Apple LogoWriter, 
flip the page back. Do you see that your initial appears as shape number 1 now? Press Esc to leave the Shapes Page. Get a new 


page and type 


SETSH 1 
The turtle is now the shape you created! Your new shape has become part of the Shapes Page. Name your page, then type 
SHAPES 


to go back to the Shapes Page. Pick one of the predefined shapes and change it. Perhaps you’d like to change the way the cat 
looks or make the car a bit more sporty. Unless you are using the Macintosh version of LogoWriter, flip the page to see your 
revised shape. When you press Esc, LogoWriter returns you to the page you just named. Try using your revised shape. 


RESTORING A SHAPES PAGE 


You can change any or all of the shapes on the Shapes Page to whatever you want. However, you must remember that 
when you replace a shape with a new one, the old one is lost. Think carefully before you press Esc after changing shapes. 


If you accidentally destroy the shapes that came with your version of LogoWriter, you can restore them by using another 
LogoWriter disk with the correct Shapes Page. Be very careful when you copy an entire Shapes Page; it is easy to accidentally 
destroy the page you want to keep. 


First, be sure you are on the Shapes Page. 
1. Put the disk with the correct Shapes Page in the disk drive and select the Shapes Page. 
2. Remove the disk with the correct Shapes Page. 
3. Put the disk onto which you want to copy the correct Shapes Page in the disk drive. 
4. Press Esc. 


Both disks now contain an identical Shapes Page. Later in this book (Chapter 14) you will learn how to copy individual shapes 
from one place to another. 


PROJECT SUGGESTIONS 


Now that you can create any shapes you want, try one of the projects from the previous section, but use your own shapes. 
For example, you can make 


* more personalized greeting cards 
¢ signs with special symbols on them 
* cartoons. 


You can then print your results with PRINTSCREEN. 


a 
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6. FILL and SHADE 


You now know how to change the pen color and the background color. With LogoWriter you can also fill in areas on the 
page with the current pen color. You can also fill areas of the page with turtle shapes—even with shapes that you have created! 


Clear your page and type 
REPEAT 4 [FORWARD 50 RIGHT 90] 
to draw a square on the screen. Next type 
PU 
RIGHT 45 


FORWARD 20 
PD 


The turtle is now inside the square: 





Now type 


FILL 


The square fills with color. Type 


CG 
SETC 5 


Use the Arrow keys to move up to the REPEAT line. Press Return/Enter to run each line below the REPEAT. Now the turtle 
draws a colored square and fills it with color. 


Notice that the pen was lifted before moving the turtle into the square. If you leave the pen down, move the turtle, and then 
type FILL, nothing will happen. This is because the turtle “‘senses” that it is already on top of a colored spot. Always be sure to 
lift the pen before moving the turtle into an area to be filled. 
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You can fill any closed area with whatever color you want. Be careful, however, that the area really is closed. Otherwise the 
color may “leak out” all over the page! Occasionally FILL does not work as you expect. If you have difficulty with FILL, move 
the turtle just a few turtle steps and then try again. Remember, keep the pen up when moving the turtle, put the pen down when 
you are ready to fill. 


Now type 
OG 
REPEAT 4 [FORWARD 80 RIGHT 90] 
PU 
RIGHT 45 
FORWARD 20 
PD 
Again you see a square with the turtle inside. Next type 
SETSH 29 
Then type 
SHADE 
and finally 
HT 


Now you see a square filled with bricks: 


een ee eee 
SETSH 29 

SHADE 

HT 

| 





Use the Arrow keys to repeat this sequence, but use a different turtle shape. The square will fill with whatever shape you 
want. 


You must remember to use the same steps when working with SHADE that you used with FILL. Lift the pen when moving 
the turtle; put the pen down before shading. Move the turtle just a few steps if you have difficulty. 


FILL and SHADE can be used to create interesting effects in drawings. Spend some time experimenting with them. 
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TIPS AND TECHNIQUES 


If either FILL or SHADE does not work properly, it is most likely because you don’t have the pen down or the turtle’s pen 
is over a dot. First, type PD and try again. If that doesn’t work, then the turtle is positioned so that LogoWriter thinks the area is 
already filled or shaded. Lift the pen. Move the turtle a small distance. Put the pen down and try again. 


After shading, you most likely want to hide or move the turtle. The original turtle shape usually distorts the pattern created 
by using SHADE. 


You can usually FILL an area after you SHADE it, but you can’t SHADE after you FILL. 


The behavior of FILL and SHADE differs slightly on different kinds of computers. Don’t be surprised if you note those 
differences when working on different machines. 


Since shading and filling areas make major changes on your page, it is a good idea to save your page before you use 
SHADE or FILL. Suppose you name your page MY.PAGE and press Esc to save it. Next, you fill an area. The FILL doesn’t 
work right, so you would probably like to begin again. First, type 


NP "JUNK 


or some other meaningless name. Press Esc. Then get the page MY.PAGE from the Contents Page and try again. 


PROJECT SUGGESTIONS 


Create a number of closed polygons on the screen. Use Turtle Move to place the turtle before drawing each design. Then 
again use Turtle Move to get the turtle inside each design to fill it. Can you create some interesting artistic effects using filled 
areas? What happens when the polygons overlap? 


Use SHADE to create patterns that are part of a greeting card. For example, you might place lines so that the edges of the 
page are filled with a shape of your choice and then place a message in the middle of the card. You might even want to design a 
turtle shape of your own to personalize the card. 


Design a sign announcing some school activity. Use a combination of filling, shading, and labels to make your sign. 


Use the LogoWriter techniques you have learned so far to create the cover for a report. You could create a turtle shape 
appropriate to the subject of the report. Remember, you can stamp shapes as well as use them to fill areas. 
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7. Using Text 


So far you have been using only graphics on the LogoWriter page. The text in the Command Center at the bottom of the 
screen is not part of the page. Recall that with Label, the letters are part of the graphics; they disappear when you type CG. In 
this chapter you will learn to put letters and numbers on the page that are not part of the graphics. 

Start LogoWriter and get a new page. Name your page by typing 
NAMEPAGE "“page.name. you. choose 


and hide the turtle then press the Up keys. (Check Appendix 8 for the keys to use for your particular machine. If you are using a 
Macintosh you can click on the page.) Notice that the cursor is now flashing at the top of the page: 


Your page name appears here. 


ss 


Pressing Upmakes (ee 
this cursor flash. ——> | 






This cursor is 
not flashing. —>| Hf 


Begin typing. The words appear on the page instead of in the Command Center. Continue typing. Do not press Return/Enter 
when you get to the end of a line: 
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This is some sample text that I can type <— Don't press Return/Enter at the 


on the page. end of lines. 
se Return/Enter to end a 
I can leave blank lines by pressing paragraph or create a blank 
Return/Enter. line. 
I can indent using the Tab key or <——The Tab key moves the 

using the space bar. @ cursor the same number of 
spaces each time your press 
it. The space bar can be used 
to make any number of 
spaces. 





Complete words automatically jump to the next line. This is called word wrap. Words on the page in text mode behave just 
like text in a word processor. In fact, you are now using LogoWriter’s built-in word processor. 


Now that you have some text on the page, press the Down key (again, check Appendix 8 or, with the Macintosh, check the 
mouse in the Command Center) to activate the cursor in the Command Center. Next type 


CG 


Nothing happens. That is because you now have words in text mode instead of graphics mode. To clear the text from the page, 
you must type 


cT 


for Clear Text. 


eee 
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To explore how the LogoWriter word processor works, clear the page (CT), hide the turtle (HT), and type the text exactly 
as shown here: 


This is an example that shows how text on 

the LogoWriter page behaves. You turn/E 
can continue to type without pressing pr des a a 
Return/Enter and the text automatically : 
wraps. 


However, you can place words 
wherever 


you want 
them by Press Return/Enter after each 
using the of theses lines. 


space bar and Return key. 


Ie we Pe a ey ea | 
CG 
CT 





Use the space bar and Tab key to indent the lines in the second paragraph. 


There are several ways to print text. With the text shown above on the page, type 


PRINTSCREEN 


and the large letters that you may have seen before with Label appear. Next type 


PRINTTEXT 


This time the words appear on the printed page in the same places that they are on the LogoWriter page, but in regular-size type. 
In addition, there are margins at the left, top, and bottom of the page. If you want double spacing, you can type DSPACE and 
press Return/Enter. Type SSPACE and press Return/Enter to get back to single spacing. 


Note: If you are using LogoWriter Version 1.0, there are no margins on the page. If you are using LogoWriter Version 1.1, 
you will need to type an SSPACE before typing PRINTTEXT. If you are using IBM Version 1.1, you must use 
DOUBLESPACE instead of DSPACE and SINGLESPACE instead of SSPACE. 


Finally, type 
PRINTTEXT80 


and the text is printed using 60 columns (unless you pressed Return/Enter after each line on the Apple of the IBM.) There are 
with margins at the left, right, top, and bottom of the page. 


Note: PRINTTEXT80 is set up for ten characters per inch (Pica type). If your printer is set for some other type style and 
you are using Apple or IBM, the text may not go all the way across the page. Sometimes turning your printer off and then on 
again will reset your printer to ten characters per inch. 

Macintosh LogoWriter does not include the SSPACE, DSPACE, and PRINTTEXT80 primitives. PRINTSCREEN does 
not cause double-size print to appear but rather makes an exact printed copy of both the graphics and the text appearing on the 
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screen. PRINTEXT prints all the text on the page. In addition, if you select a portion of text and then type PRINTTEXT, only 
the selected portion appears on the printed page. 


Take a few moments to be sure you understand how each of these commands for printing text works. Note that 
PRINTSCREEN prints all of the text and graphics that appear on the page. PRINTTEXT and PRINTTEXT80 print only text. 


Everything you have created so far using LogoWriter has been visible on the page. Continue working with the page of text 
you created above. Place the cursor after the last word, and begin to type. Type whatever you want. Press Return/Enter 
whenever you want. What happens when you get to the bottom of the page? Did your screen scroll like this? 


Return/Enter and the text automatically 
wraps. 


However, you can place words 
wherever 
you want 
them by 
using the 
space bar and Return key. 


If you continue to type until you reach 
the bottom of the screen, the text at 
the top of the screen will begin to 
scroll up. You can't see it, but it is 
still there. # 


a ee eee | 
cG 

cT 

a 





There are a number of key combinations that help you move around on the page. The ways you can move around on the 
page are listed below. Look at the summary in Appendix 8 to find which keys to use for your particular type of machine. (Not 
all of these keystrokes work for every machine on which you can use LogoWriter.) Experiment with each of the following 
movements and their respective key combinations for your computer until you are comfortable using them. You might even 
want to write which keys to use on your machine next to each item in the list below. 


Top of Page 

Bottom of Page 

Previous Screen 

Next Screen 

Beginning of Line —_ (Note that in some versions of LogoWriter, Beginning of Line and End of Line 
End of Line move the cursor from one Return/Enter character to the next.) 


If you are using Macintosh LogoWriter, you can also use the mouse and the menus to edit text. Often it is easier to do your 
text editing using the features of the Macintosh than to use the available key combinations. 


It is much easier to change what you have written on the page using the LogoWriter word processor than it is when you use 
Label. You can add, delete, and correct text with ease. That is why you should use Label only for short graphics signs and 
labels. 


With some text on the page, try this. Move the cursor to the middle of a line and start typing. Notice how the words you 
type are automatically inserted. That is, they move out of the way as you type. 


ey IESESEIy_ ____========___===E=E=E>EE>EE>E>EEe—EeEe—>—>>E>>=>=—_—>—>E>E>E>E>E>E>E>E>E=>E>~™""_ _]__>>>>>>>>>~—_— E> _ L——_—  _ _ 
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Next, try pressing the Delete/Backspace key. Notice that this key causes letters to be erased from right to left. When you 
want to erase something, you can place the cursor after it and then press Delete/Backspace. Experiment with making changes 
in the text on the page. (You can delete the character under the cursor using Control-D if you are using an Apple computer.) 


When you are deleting text, some apparently strange things can occur: 


* Sometimes words become “glued” together. Press the space bar to separate them. 

Sometimes words jump from one line to the next. This is because you have deleted the invisible space between the 
words. 

If you put the cursor on a blank line and press Delete/Backspace, the blank line will disappear. This is because you 
have deleted the invisible “carriage return” character. Simply press Return/Enter to replace it. 

If you put the cursor on the first character of a paragraph and press Delete/Backspace, the paragraph moves up to join 
the one before it. Again, the invisible carriage return character was deleted. Press Return/Enter to put it back. 


Note: If you are familiar with word processing, you may want to learn more of the capabilities of the LogoWriter word 
processor. If so, see Chapters 13, 14, and 22. Keep in mind, however, that LogoWriter includes only an entry-level word 
processor. You will not find many of the capabilities that are included in today’s powerful software that is devoted entirely to 
word processing. 


If you are using the GS version of LogoWriter, you can change the color of the text (and the cursor) on the page by using 
the command SETTC. Typing 


SETTC 2 


changes the text and the text cursor to color number 2. If you want to know the color number of the text under the text 
cursor, you can type 


SHOW TC 
TC reports the text color number. 


In Macintosh LogoWriter you can change the font and font size used on the page by using the Font menu. All the text 
on the page is changed, but the Command Center is unaffected. 


TIPS AND TECHNIQUES 


If you have experience with other word processors, you may wonder how you can accomplish such tasks as centering 
icxt, setting margins, or underlining words. None of these features is available in the LogoWriter word processor. However, 
the LogoWriter word processor has its own advantages. It is very easy to use. There are no elaborate menus or key 
combinations to learn. In addition, you will soon learn that you can easily insert graphics into your text. If you want to do 
simple desktop publishing, then LogoWriter is an excellent tool. If you want to write long papers, you probably want to use 
another word processor. Don’t try to make the LogoWriter word processor meet all of your word-processing needs. 


Text created in some other word processors can be “imported” into LogoWriter, and text created in LogoWriter can be 
“exported” to some other word processors. To see if you can exchange text between your version of LogoWriter and your word 
processor, see Appendix 7. 


If you enter more than a screen full of text using the Macintosh version of LogoWriter, the scroll bar at the right side of 
the page becomes grey instead of white. If you move around in the text using the scroll bar, the blinking cursor may 
disappear. To locate the cursor, use the scroll bar again to move through the text. 


If you type CT, all the text on the page disappears, including the text that has scrolled off the page. If you accidentally 
type CT, it is possible to get your text back. Before you press any other keys, type 


UNDO 
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in the Command Center and your text will reappear. (Note: UNDO is available only from the Edit menu in Macintosh 


LogoWriter and is not available in LogoWriter Versions 1.0 and 1.1). 


PROJECT SUGGESTIONS 


Now that you know how to place text on the screen, you can use this capability to do a variety of things: 


¢ Make a sign (printed using PRINTSCREEN). 


¢ Doa short report for another class. 


Write a letter to a friend. 


Write a poem. 


Make a design or picture using letters, numbers, and other keyboard symbols. (Pictures such as this used to be called 


“typewriter pictures.”) 
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8. Mixing Text and Graphics 


You have now learned how to put text on the page. Earlier you leamed how to put graphics on the page using the turtle and 
Label. Using LogoWriter, you can combine graphics and text on the same page. Get a new page and try this: 


REPEAT 4 [FORWARD 50 RIGHT 90] 
Then, use Label to write “This is my Square” under the square. Now use the Up keys and type “The turtle can draw whatever 
you tell it to draw.” Your page should look like this: 


The turtle can draw whatever you tell it 


to draw. 
B 


This is my Square 


REPEAT 4 [FORWARD 50 RIGHT 90] 
6 





Next, press Esc to save the page (You will need to name it). Get the page and again type 


CG 
What happens? Do you see why? 


Next type 


RESTORE 


to get back the page you saved. Now type 


CT 
What happens? Do you see why? 


When you are working on a project that contains both text and graphics, you can correct the parts separately, or even start 
one part over without erasing the other. This can be very handy when working on a more complex project. 
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TIPS AND TECHNIQUES 


When you have put a lot of work into a LogoWriter page, it is very frustrating to make a major error or accidentally erase 
your work. You have learned a number of techniques for protecting your work. When you make a mistake, don’t panic. Before 
you press any keys, take a moment to think. 


* Can you use UNDO to restore lost text? Immediately go to the Command Center and type UNDO (or use the pull down 
menu on the Macintosh.) 

¢ Have you recently saved the page? If so, type RESTORE in the Command Center to get back a recent version of your 
work. 

¢ Have you been saving your pages on a regular basis using names like MY.PAGE1, MY.PAGE2, MY.PAGE3, and so 
forth. If so, you can go to the Contents Page and get the most recent copy of your page. 


If none of these techniques work this time, in the future, make it a habit to save your work every 10 to 15 minutes. Better yet, 
save it every time you complete a major change on your page. The time taken now to save your work will pay off later if you 
make a mistake. 


PROJECT SUGGESTIONS 


Use a mixture of text and graphics to create pages of your choice. You might want to make a greeting card, a sign, or a page 
for a report. Remember that you can create any shape you want by using the Shapes Page. Try extending some of the Project 
Suggestions made at the end of Chapter 7 by adding graphics to them. 
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9. Writing Procedures 





All the pages you have created so far have been done either by typing commands in the Command Center or by putting 
text directly on the page using the LogoWriter word processor. When you saved, everything you created was put on your disk 
exactly as it appeared on the page. 


Have you ever created a neat graphics design that you would like to use on another page? Perhaps you remembered the 
commands you used to make it, perhaps not. Without a list of the commands, it can be hard to recreate a graphics design. 
You have already seen that the commands in the Command Center are not saved. If you start LogoWriter at another time and 
get your page, the commands you used to create it are not there. 


There is a way to save commands you have used to create pages in Logo. Recall that you could flip the Shapes Page to 
see magnified copies of the shapes. You can also flip the page on which you put text and graphics. Try it. Use the Flip keys 
(see Appendix 8) to see the back of the page. If you are using Macintosh LogoWriter, you can click on the “F/F” box at the 
top right corner of the page. Notice that it says “Flip Side” at the top of the screen and that the Command Center is still 
visible. Compare your screen with the screen below. Can you locate both cursors? 






This cursor is 
flashing. ——>| @ 


This cursor is 
not flashing. ——>] 


Use Flip to flip back to the front of the page. Notice the location of the flashing cursor. Where is it when you are on the 
front of the page? Where is it when you are on the back of the page? 


Now try this. Start on the front of the page. Flip the page and use the Down keys to get to the Command Center. Type 
REPEAT 4 [FORWARD 50 RIGHT 90] 


What happens? 
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Flip to the back of the page and type the lines shown below: 


ES °°: 
TO SQUARE 

CG 

REPEAT 4 [FORWARD 50 RIGHT 90] 

END 

|_| 





Flip to the front of the page and type 
SQUARE 
What happens? You have just written your first Logo procedure. 


A procedure is a collection of Logo commands. Procedures must begin with the word TO and end with the word END. The 
structure of a procedure is as follows: 


TO name.of.procedure <— title line 
Commands go here <— body of the procedure 


END 
Procedures must be written on the back of the page. They are then saved with the page. 


In most versions of Logo there is a separate “editor” where you write procedures. This editor is usually a low-level text 
processor that requires you to learn a set of editing keys often different from those used in the “immediate mode,” where 
commands are typed one line at a time. The LogoWriter “editor” involves using the word processor on the flip side of the page. 
When writing procedures in LogoWriter you use the same editing keys that work in the LogoWriter word processor and in the 
Command Center. 


While the mechanics of procedure writing are rather simple, the idea embodied in procedure writing is profound. When you 
create a series of instructions to complete a particular task and then put them into a named procedure, you have “taught” Logo a 
new word. This new word behaves exactly as if it were a primitive. If you don’t look on the flip side of the page, you have no 
way of knowing whether the commands you type in the Command Center consist of primitives or user-defined procedures. The 
fact that you can easily create procedures that function exactly like primitives is what makes Logo an easily extensible language. 


The flip side of the LogoWriter page can contain as many procedures as the memory of the computer and/or the version of 
LogoWriter you are using allows. Each of these procedures must have a unique name. Each new name becomes part of the 
LogoWriter vocabulary available when you use the page. 








79) 9. Writing Procedures 


Because all of the commands you have learned so far can be used in a procedure as easily as they can be used in the 
Command Center, you now have the tools to write procedures to do many interesting things. 


You can move the turtle around: 
TO PLACE.TURTLE 
CG 
PU 
FORWARD 20 
RIGHT 60 
FORWARD 30 
PD 
END 


You can change the shape of the turtle and the color of its pen: 


TO CHANGE . TURTLE 
ST 

SETSH 25 

SETC 3 

END 


You can stamp turtle shapes: 


TO STAMP .IT 
SETSH 15 

PD 

STAMP 

PU 

FORWARD 20 
END 


Take some time now to experiment with writing a procedure. Notice as you experiment how powerful this idea of 
procedure writing is. Now you are teaching Logo how to do new things. The computer is now under your control. 


TIPS AND TECHNIQUES 
When you begin using the flip side of the page to write procedures, it is easy to get lost. Learn to look at the screen 
carefully. 


* Are you on the front of the page or the flip side? (You see “Flip Side” if you are not on the front.) 
¢ Where is the cursor flashing? 

Not at all? You are in Turtle Move or Label mode. 

At the bottom of the screen? You are in the Command Center. 

At the top of the screen, no “Flip Side”? You are in the word processor. 

At the top of the screen; it says “Flip Side”? You are ready to write procedures. 


You can use the Up and Down keys on either side of the page. That is, you can use Down to get to the Command Center 
when you are writing procedures. Be especially careful if you do this. If you accidentally type CT, you can erase all your 
procedures. (Remember, you can use UNDO.) 


Don’t forget the END on procedures. Leaving out the END statement will confuse LogoWriter. It won’t recognize the next 


procedure in your list. It is helpful to put a blank line between procedures. Then you can more easily see where one procedure 
ends and the next begins. 
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PROJECT SUGGESTIONS 


Write a procedure to make a small design. Flip to the front side of the page and then use a combination of Turtle Move and 
your procedure to place your design in various places on the page. 


Write a procedure to stamp two different shapes on the page. Flip to the front side of the page and use a combination of 
REPEAT, Turtle Move, and your procedure to make a border of shapes on the page. 


Write a procedure to make an elaborate graphics design using the turtle. Flip to the front side, use your procedure to make 
the design, and then use the word processor (press the Up keys) to add a description of your design on the screen. 


Create a shape of your own and then write a procedure to stamp your shape in a pattern on the page. Add some text using 
Label. (In the next chapter you will leam how to put LABEL into a procedure.) 


Write a procedure that draws a graphics design and changes the pen color randomly with each line it draws. You might use 
something like the fluffy ball created in Chapter 2. Use Label to put a title on your design. 
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10. More Than One Procedure 


You now know how to write a procedure using the flip side of the page. As mentioned in the last chapter, you can write as 
many procedures as you want on the flip side of the page as long as there is space in the memory of the computer. 


Carefully follow the example given below. It shows you how to write a number of procedures and put them together into a 
program. 


Suppose you wanted to have the turtle draw a house on the page and then put a “For Sale” sign on it. You can, of course, 
do this from the Command Center. However, if you do it with procedures, then you can easily make a number of identical 
houses. 


To begin, notice that you can draw a simple house made up of a square for the main part of the house and a triangle for the 
roof. Flip the page and write these procedures for drawing a square and a triangle: 


TO SQUARE 
REPEAT 4 [FORWARD 40 RIGHT 90] 
END 


TO TRIANGLE 


REPEAT 3 [FORWARD 40 RIGHT 120] 
END 


Flip the page to the front. Type 


SQUARE 
TRIANGLE 





You see the parts of the house, but they are not in the right place. Type CG and see if you can figure out the commands to get 
the roof in the right place. These commands should become part of a procedure to get to the roof. One solution might be 
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TO GET.TO.ROOF 
FORWARD 40 
RIGHT 30 

END 


Now flip the page and type 


CG 

HT 

SQUARE 

GET .TO.ROOF 
TRIANGLE 


Does the house look the way you want it to? If not, modify the procedures until you are satisfied with your house. These 
procedures you create can become part of a HOUSE procedure: 


TO HOUSE 
SET.UP 
SQUARE 

GET .TO.ROOF 
TRIANGLE 
END 


TO SET.UP 
OG 


HT 
END 


Now you can type HOUSE from the Command Center and see your house. Notice that a SET.UP procedure was added to 
prepare the page for the house drawing. 


Next, you need to work on the “For Sale” sign. This time you can’t use Label because you want the sign to be created in a 
procedure. This can be done by using the LABEL command. From the Command Center, type 


CG 
LABEL [HELLO] 


Notice that the word “Hello” appears next to the turtle. You can type HT to see the word better. Remember how you corrected 
errors in Label mode by typing over them? The same thing happens when you use LABEL as a command in the Command 
Center. Move the cursor up to the 


LABEL [HELLO] 

line in the Command Center and press Return/Enter. Do this several times. What happens? 
Using this technique, you can make flashing signs. Try typing 

REPEAT 10 [LABEL [HELLO] WAIT 10] 


WAIT 10 causes LogoWriter to pause for 10/20, or 1/2, second. Try changing the length of the pause until you have a sign that 
flashes at a speed you like. 


LABEL works differently in Macintosh LogoWriter. You must type PX (Pen reverse) before the REPEAT instruction and 
PD afterwards. See your documentation for more details. 


Now you can make a flashing “For Sale” sign for the house. Flip the page and type 


TO FLASH.SIGN 
REPEAT 9 [LABEL [For Sale] WAIT 20] 
END 








vr) 10. More Than One Procedure 


The sign isn’t in the best of places. You need to write a procedure to move the turtle before placing the sign. For example, 
you might write 


TO PUT.SIGN 
PU 

RIGHT 60 
FORWARD 50 
PD 

HT 

END 


However, there is a neat trick for converting your use of the Label keys into commands that you can then use in a 
procedure. First, use your procedure to draw your house. Type 


HOUSE 


Next, use the Turtle Move keys to place the turtle where you want the sign to appear. Press Escape to leave Turtle Move. In the 
Command Center type 


SHOW POS 


Two numbers enclosed by square brackets appear. These are the coordinates of the turtle. (POS reports the current location of 
the turtle in Cartesian Coordinates. See Chapter 36 for more details.) Suppose you see 


(60 25] 
in the Command Center. Flip the page and write the following procedure: 


TO PLACE.SIGN 
PU 

SETPOS [60 25] 
PD 

END 


SETPOS sets the position of the turtle to a location given in the coordinate list that follows it. Now type 


HOUSE 
PLACE .SIGN 
FLASH.SIGN 


The house appears with its flashing sign. Now you can put this all together in one procedure. Flip the page, move the cursor to 
the top of the page and type 


TO HOUSE.AND .SIGN 
HOUSE 

PLACE .SIGN 
FLASH.SIGN 

END 


Now, typing HOUSE.AND.SIGN in the Command Center gives you this picture, complete with flashing sign! 
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HOUSE .AND.SIGN 
a 





When you are writing a program with a number of procedures, it is a good idea to include a description of the program. On 
the flip side of the page, move the cursor to the top and type a description. You might type something like 


<<The following program draws a house with a flashing “For Sale” sign. Type HOUSE.AND.SIGN in order to run 
the program.>> 


The “<<” symbols aren’t necessary. They just set off the remark from the procedures themselves. 
The procedure HOUSE.AND.SIGN is the main procedure, or top-level procedure. It uses a number of other procedures. 
These procedures are called subprocedures of HOUSE.AND.SIGN. A good way to visualize the relationships among 


procedures is by using a procedure tree. In a procedure tree, a subprocedure is drawn below the procedure that uses it. For 
example, the procedure tree for HOUSE.AND.SIGN looks like this: 


HOUSE.AND.SIGN 


HOUSE PLACE.SIGN FLASH.SIGN 


SET.UP SQUARE GET.TO.ROOF TRIANGLE 





Notice that the HOUSE procedure, which is a subprocedure of HOUSE.AND.SIGN, has four subprocedures of its own. 


The word superprocedure is also commonly used to describe relationships among procedures. For example, 
HOUSE.AND.SIGN its a superprocedure of FLASH.SIGN. 
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To summarize: 

¢ HOUSE.AND.SIGN is the main, or top-level procedure. 

¢ HOUSE, PLACE.SIGN, and FLASH.SIGN are subprocedures. 

* HOUSE.AND.SIGN is a superprocedure of HOUSE, PLACE.SIGN, and FLASH.SIGN. 
* SQUARE, GET.TO.ROOF, and TRIANGLE are subprocedures of HOUSE. 

* HOUSE is a superprocedure of SQUARE, GET.TO.ROOF, and TRIANGLE. 


Notice how much easier it is to see the relationships among procedures when using a procedure tree. The list of the relationships 
is hard to follow. The procedure tree gives you a visual image of the structure of your program. You should always draw a 
procedure tree when you are working with more than two or three procedures. 


There are some “rules of thumb” you should remember when you are drawing a procedure tree: 


1. The name of the program (the procedure name you type to run the program) is at the top of the procedure tree on a line by 
itself. 

2. Each subprocedure of the main procedure is listed on the next level (or line). These subprocedures are listed left to right as 
they occur in the main program. That is, the first subprocedure is listed on the left; the next subprocedure used is listed to 
the right of the first, and so forth. 

3. Aline connects each procedure with its subprocedure(s). 

4. Each procedure in the program, along with its subprocedures, is represented using the rules given in Step 2. 

5. Ifa procedure is a subprocedure of more than one procedure, it should appear “under” each procedure from which it is 
called. 

6. Ifa procedure “calls itself’ (Chapter 19), then the name of the procedure appears below the name of the procedure 

connected by a line, just like any other subprocedure. 

All “user-defined” procedures (those that you write) should appear in the procedure tree. 

8. No primitives (such as CG, FORWARD, or REPEAT) are listed in the procedure tree. 


al 


When you have completed your procedure tree, you should be able to tell exactly what procedures are called from any 
procedure. You should be able to tell what procedures call any subprocedure. A carefully drawn procedure tree can be very 
helpful in solving any problems you have with your program. 


TIPS AND TECHNIQUES 


Mistakes in computer programs are called “bugs.” The process of removing these errors is called “debugging.” You will 
quickly learn that you spend more time debugging your Logo programs than you do writing them. Don’t let that discourage you. 
Even professional computer programmers spend most of their time debugging. You should consider the time you spend 
debugging as part of the learning process. 


The ideas in this section of each chapter have been designed to help you avoid or fix bugs when you were working in the 
immediate mode. Increasingly, this section will include techniques for debugging. Read them carefully. They will save you a lot 
of time in your future work. 


When you are working with a number of procedures, you should be sure that each procedure works by itself. That is, after 
writing any one procedure, flip the page and type the name of the procedure. As you build up your program, test each procedure 
as you go. Thus, in the above example, after you tested SQUARE, TRIANGLE, and GET.TO.ROOF separately, you should 
test HOUSE to be sure all the pieces work together properly. Don’t try to write your entire program all at once and then test it by 
typing the name of the top-level procedure. There are simply too many things that can go wrong in a program that is more than 
two or three procedures long. 


Give your procedures meaningful names and keep your procedures quite short. It is easy to find yourself adding more and 
more commands to a procedure. Soon you have a very long procedure that is hard to debug. Perhaps the name of the procedure 
no longer describes the function of the procedure. Take time to subdivide and rename procedures as you work. It will save a lot 
of time later when you are debugging. 
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PROJECT SUGGESTIONS 

Now that you know how to write multiple procedures, plan a picture of your choice and write the procedures to create it. 
Move along step by step like the example in this chapter. Draw a procedure tree as you go. Be sure to keep the individual 
procedures short. You should not have any procedures longer than 20 lines, with one statement on each line. If you put too 
much into a procedure, it becomes hard to find errors. 
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There are several ways to go about creating programs. Different people prefer different approaches. Different computer 
languages lend themselves to different methods. Now that you are beginning to write programs containing a number of 
procedures, you should spend some time thinking about the ways to design a program. You should be examining your own 
programming to see which method(s) suit your particular learning style. 


TOP DOWN PROGRAMMING 


Top down programming refers to writing a program “from the top.” Think about the HOUSE.AND.SIGN program from 
the previous chapter. If you use a top down approach, the first procedure you write would be 


TO HOUSE.AND.SIGN 
HOUSE 

PLACE.SIGN 
FLASH.SIGN 

END 


Next you would write the HOUSE procedure: 


TO HOUSE 
SET .UP 
SQUARE 
GET.TO.ROOF 
TRIANGLE 
END 


Then you would write SET.UP, SQUARE, GET.TO.ROOF, and TRIANGLE. Finally, you would write PLACE.SIGN and 
FLASH.SIGN. 


With this method, you plan the whole and then write ever smaller parts. This is a very regimented and structured 
approach to problem solving. You must do a lot of planning in advance. You need to know exactly what you want to 
accomplish before you even begin. This approach allows little room for exploration as you go. 


BOTTOM UP PROGRAMMING 

In bottom up programming, you start with small pieces and build them up into a complete program. If you used bottom 
up programming in the HOUSE.AND.SIGN program, you wouldn’t start with a plan. You might first create the SQUARE 
procedure and then the TRIANGLE procedure. After some fiddling with these, you might discover that, when put together, 
they make a nice house. That might lead to the HOUSE procedure. 


You might be experimenting with the LABEL command and get the idea to write a procedure to put a sign next to the 
house. Next would come the FLASH.SIGN, and then the PLACE.SIGN procedure. Last of all, the HOUSE.AND.SIGN 
procedure would be written. 


With this method, there is little advance planning. You play with an idea, turn it into a procedure, and let that idea lead 
you to another one. You have little or no idea where you are going as you begin. Logo lends itself to the bottom up style of 
programming better than most programming languages. Languages like Pascal all but force programming in a top down 
style. 


Much of what is written about Logo implies that the only “right” way to program in Logo is bottom up. This emphasis 
on bottom up style grows out of the philosophy of discovery learning that is closely allied with Logo. It is assumed that the 
Logo programmer will experiment with an idea and then use that idea as part of a larger project. However, in the first part of 
this chapter you saw how one might write a program using a top down approach to problem solving in Logo. 
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MIDDLE OUT PROGRAMMING 

Very few people actually program either in a true top down or bottom up style. Most people use some combination of 
methods for writing programs, which might be described as “middle out.” Middle out is the method that was actually used for 
writing the HOUSE.AND.SIGN program. There was an initial idea of what the program should do. Then small parts were 
written. Finally all the pieces were put together. Some things were done top down, other things bottom up, but most things 
were done from the middle, working both towards the top and the bottom. 


POLISHING YOUR PROGRAM 

It doesn’t really matter what programming style is used to do a project. However, it is best if the final program looks 
structured and well organized, much as if it had been done in a top down manner. That is, there should be a top level procedure 
with a title that describes the entire program. This top level procedure should be made up primarily of procedure names whose 
titles describe the subparts of the program. Many of the subprocedures in the program may also be made up of procedure 
names that describe even smaller parts of the program. 


Both the programming process and the final product are important in any programming project. During the development 
of a project, you probably focus on writing the code and on debugging the results. (Recall that things in programs that don’t 
work the way you want are called “bugs.”) However, when you have finished a program in Logo, it should be polished for 
“publication,” just as you polish your final draft of a report before you turn it in to a teacher or employer. 


What is the “correct” style to use when writing a Logo procedure? Are there “rules” you should follow? The issue of 
programming style is one about which there is very little agreement within the Logo community. At one end of the spectrum 
are those who feel that to impose any rules for writing procedures is inappropriate. They feel that such rules will interfere 
with creativity and exploration. The methods used in this book employ a very consistent and somewhat rigid style that lics 
nearer the other end of the spectrum. 


Any Logo programs you write should be polished for “publication” no matter who is going to see them. Polishing the 
final product makes it more readable both to yourself and to others. You will be surprised how quickly you can forget the 
details of a program that you spent many hours writing. Only weeks later, a poorly written program can be very hard to 
untangle. 


Here are some guidelines to help you begin developing a readable programming style: 


1. Procedures should have meaningful names. That is, the name of the procedure should describe exactly what happens in 
that procedure. 


2. There should be no more than one instruction per line. 
3. No procedure should be longer than 20 lines (approximately the number of lines that fit on the page at one time). 


4, The main or top-level procedure should contain only user-defined procedure names. That is, you should not use a 
LogoWriter primitive in the main procedure. 


5. If an instruction is longer than one line, you should indent the second and subsequent parts of the line in a logical and 
readable manner. 


6. When you use procedure inputs or global names, you should use meaningful names that describe the function of that 
name. (Inputs and names will be discussed later in this book.) 


These rules are perhaps unnecessarily rigid for your long-term work with Logo programming. However, they are designed 
lo give you specific guidelines to follow from the outset and will help you in debugging your future, more complex 
programs. As you continue your work with Logo beyond this book, you will no doubt relax or modify these rules in ways 
that are comfortable for you. 


Programs written using the above guidelines are much easier to work with. Other people can easily tell what each part 
does. You can more easily make changes in your own work at a later date. Most importantly, though, is the way in which a 
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program written in this style is easy to debug. Sometimes the bugs are easy to find, sometimes they aren’t. If the program is 
written well, then the debugging process takes less time. 


PROJECT SUGGESTIONS 


Select a project that involves writing a number of procedures. As you are working on it, examine your own 
programming style. Which of the styles mentioned above best describes the way you prefer writing programs? Be sure your 
final program is polished for publication. 
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12. Using Print 


You have always put text directly on the front of the page by using the LogoWriter word processor. There is a command in 
LogoWriter for putting text on the page as well. Be sure you are on the front of the page and type 


PRINT [HELLO] 


PRINT [HELLO] 
a 





The word “HELLO” appears at the top of the page. You can also use PRINT from a procedure. Flip the page and type 


TO GREET 
PRINT [Greetings, Mary!] 
END 


Now, flip the page and type 
GREET 
Then, 


Greetings, Mary! 


appears on the page. 


Each time you issue a PRINT command, LogoWriter prints what follows and then moves the cursor to the next line. Thus, 
you can write a procedure to create a more elaborate greeting as follows: 


TO GREET 

cT 

PRINT [Greetings, Mary!] 
PRINT [How are you?] 
PRINT [I’m fine!] 

END 
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When you run this procedure, 


Greetings, Mary! 
How are you? 
I’m fine! 


appears on the page. 
What if you want some blank lines between the parts of your greeting? You can add blank lines by printing an empty line. 


TO GREET 

CT 

PRINT [Greetings, Mary!] 
PRINT [] 

PRINT [How are you?] 
PRINT [] 

PRINT [I’m fine!] 

END 


Then your message will be double spaced: 


How are you? 


I'm fine! 





What if you want to put some spaces in front of some of the lines? You can do this by inserting blanks. There are several 
ways to do this. One is to use the backslash (\) to quote a blank space (see Chapter 17). Another is to use CHAR 32. CHAR 32 
is simply a way to represent a space. Thus, you might enter 


TO GREET 

Cr 

PRINT (Greetings, Mary!) 

PRINT [] 

(PRINT CHAR 32 [How are you?]) 

PRINT [{] 

(PRINT CHAR 32 CHAR 32 [I am fine!]) 


END 
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If you type GREET, you now see 


How are you? 


I'm fine! 





Did you notice the parentheses () around the last two PRINT statements? These allow PRINT to have more than one input. 
In this case both CHAR 32 and the list to print are inputs to PRINT. You can have as many inputs to PRINT as you want by 
using parentheses in this way. 


Inserting spaces by adding a lot of CHAR 32 in the PRINT line is a bit cumbersome. Here is a “tool” procedure you can 
use. (Perhaps you’ll want to keep it on a separate page for use later.) You’ll learn more about writing procedures like this in 
Chapter 26. 


TO SPACES :NUMBER 
REPEAT :NUMBER [INSERT CHAR 32] 
END 


Now, the GREET procedure becomes 


TO GREET 

cT 

PRINT [Greetings, Mary!] 
PRINT [] 

SPACES 1 

PRINT [How are you?] 
PRINT [] 

SPACES 2 

PRINT [I’m fine! ] 

END 


TIPS AND TECHNIQUES 


When writing a procedure using PRINT, be sure you are on the front of the page before you run it. If you use the Down 
keys to go to the Command Center instead of flipping the page, the text after PRINT will appear on the flip side. Text created by 
the PRINT statements in your procedure will be mixed with your procedures themselves. 


If you know another programming language, such as BASIC or Pascal, take special note of the use of parentheses with 
PRINT. The left parenthesis goes before the word PRINT, not after it. 
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PROJECT SUGGESTIONS 
Write a procedure to put a poem spaced neatly on the screen. Make use of blank lines and initial spaces. 


Write a procedure to paint a “word picture.” It might be a pun, like 


MAN (man overboard) 
BOARD 


or something more descriptive, like 


FALLING D 
O 
W 
N 


——————————————EEEEEEEEEEEEEEEEEEIyIyIIlyyIyEIyIEyyyEEEOEOEEEEEOEEEEEEEe 
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13. Printing Text on a Printer 


You have probably printed your work in LogoWriter using PRINTSCREEN. The PRINTSCREEN command prints 
graphics and text exactly as they appear on the page. If you are using the Apple or IBM versions, the letters are “double sized,” 
unlike the kind of printing you usually get from a word processor. You have now used both the word processor mode and the 
PRINT command to put text on the page. In Chapter 7, you learned that you can print text in a normal size using the 
PRINTTEXT and PRINTTEXT80 commands. These commands work in the same way whether you put text on the page using 
the word processor or the PRINT command. 


Recall that 
PRINTTEXT 


causes LogoWriter to print the text with the lines broken exactly as they appear on the screen, but indented one inch (10 
characters) on the paper. In the Apple and IBM versions, you can also use 


PRINTTEXT80 
This prints the text with an inch-wide left margin and a 60-character line. 


You can also change the spacing of text you want to print in the Apple and IBM versions. There are two LogoWriter 
primitives that allow you to change spacing. 


SSPACE 


causes text to be printed with no extra spaces between lines. 


DSPACE 


causes the text to be double spaced. Before you print anything, you should decide whether you want single or double spacing. 
It’s a good idea to type either SSPACE or DSPACE in case the person who used LogoWriter before you changed the spacing. 


Recall also that there are a few differences among versions of LogoWriter. 


In Version 1.0, there are no margins on the page. 


In some versions of LogoWriter, you will need to type SSPACE before typing PRINTTEXT in order to have single- 
spaced text. 


PRINTTEXT80 is set up for 10 characters per inch (Pica type). If your printer is set for some other type style, the text 
may not go all the way across the page. Sometimes turning your printer off and then on again will reset your printer to 10 
characters per inch. 


In IBM Version 1.1, you must use DOUBLESPACE instead of DSPACE, and SINGLESPACE instead of SSPACE. 


Macintosh LogoWriter, does not include the SSPACE, DSPACE, and PRINTTEXT80 primitives. 


In Macintosh LogoWriter, PRINTSCREEN does not cause double-size print to appear but rather makes an exact printed 
copy of both graphics and text that appear on the screen. 


In Macintosh LogoWriter, if you select a portion of text and then type PRINTTEXT, only the selected portion appears on 
paper. 
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TIPS AND TECHNIQUES 


When you are printing procedures, you should always single space and use PRINTTEXT. Double spacing makes 
procedures harder to read and debug. PRINTTEXT shows you the procedures exactly as they appear on the screen. 


PROJECT SUGGESTIONS 

Use the word-processing capabilities of LogoWriter to prepare a short paper for another course. Then try printing it in 
different ways: single and double spaced, using only 40 columns, and using the full width of the paper. You might even want to 
compare normal text with the larger text produced using PRINTSCREEN. If you are using the Macintosh version, experiment 
with different fonts and font sizes. 
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14. Cut, Copy, and Paste 


In most word processors, you can “pick up” a piece of text from one place and either copy it or move it to another place. 
This allows you to easily rearrange things you have written. With the LogoWriter word processor, you can also move text from 
one place to another. 


IN THE WORD PROCESSOR 
After you start LogoWriter, press the Up keys to move the cursor onto the page. Then type the following text: 


This is a sentence that will be used to 
practice using Select, Cut, Copy, and 
Paste. # 





Next, use Top of Page to move to the upper left corner of the page. (See Appendix 8 for the computer keys you need to use in 
this chapter.) Then press the Select keys. Nothing seems to happen. Now use the Arrow key to move to the right. Characters 
that you pass over become the inverse of what they currently are. Use the Left, Right, Up, and Down Arrows to highlight the 
text shown below: 


i ots te et - —8 o O B o Wok Tn on 08-0 oan <n Os ol MCU —To MR oo) 


PeCeeet—s using Select, Cut, Copy, and 
Paste. § 





Now press the Cut keys. The highlighted portion disappears. Move the cursor until it is after the word “Paste” in the above 
paragraph. Then press the Paste keys. The sentence now looks like this: 


using Select, Cut, Copy, and 
Paste.This is a sentence that will be 
used to practice Hf 
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Next, highlight the section shown below by using the Select and Arrow keys: 


using Select, Cut, Copy, and 


Seaa—-ee This is a sentence that will be 
used to practice. H 





00 cenncececcescoeccccccccccesccccnce: 


Press Copy. The highlighting disappears. Move the cursor until it is after the word “practice.” Press Paste and the paragraph 
looks like this: 


using Select, Cut, Copy and Paste.This 
is a sentence that will be used to 
practice.using Select, Cut, Copy and 
Paste. # 





Take some time to experiment with using Select, Cut, Copy, and Paste. Don’t worry if you have a few problems at first. If 
you get “lost” and aren’t sure where you are in the text-moving process, press Esc and try again. 


If you are using a Macintosh, you can use the Edit menus and/or the mouse to Select, Cut, Copy, and Paste. 


ON THE FLIP SIDE OF THE PAGE 


The text-moving commands work exactly the same way on the flip side of the page. Suppose you have the following 
procedure: 


TO SQUARE 
REPEAT 4 [FORWARD 50 RIGHT 90] 
END 


and you decide you would like to have a procedure to draw a triangle. You can use Select, Copy, and Paste to save typing. 


Put the cursor on the word TO. 

Press Select. 

Use the Arrow keys to highlight the whole procedure. 
Press Copy. The highlighting disappears. 

Move the cursor to after the word END. 

Press Paste. 


ANnNfwnre 


You now have a second copy of the procedure: 
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es °° 
TO SQUARE 

REPEAT 4 [FORWARD 50 RIGHT 90] 

END 


Change the procedure name. —»] TO SQUARE 

Change the numbers. —————>}| REPEAT 4 [FORWARD 50 RIGHT 90] 
END 
ppt 





If the title line of the copy of the procedure is next to the END statement of the original procedure, simply move the cursor until 
it is after the first END and press Return/Enter a couple of times. In fact, it is generally a good idea to leave a blank line between 
procedures. It makes your program easier to read. 


Finally, change the word SQUARE to TRIANGLE. You can do this easily by putting the cursor on the S of the word 
SQUARE, and pressing Erase to End of Line (see Appendix 8). Then type the word TRIANGLE. Next, change 4 to 3, and 90 
to 120. You now have written a TRIANGLE procedure with very little typing. 


222 
TO DESIGN 
CG 
SETBG 5 


REPEAT 40 [FORWARD 40 RIGHT 117 





At first, making copies like this may seem to take more ume than typing them. However, with practice you will find that using 
Cut, Copy, and Paste saves you a lot of time. 


FROM THE COMMAND CENTER 
These text moving commands work nearly anywhere in LogoWriter. Suppose you typed the following commands in the 
Command Center: 


CG 


SETBG 5 
REPEAT 40 [FORWARD 40 RIGHT 117] 


and that you really like the effect created. You can use your new knowledge to make these commands into a procedure without 
retyping. 
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Place the cursor on the C of CG. 

Press the Select keys. 

Use the Arrow keys to highlight all three lines. 

Press Copy. The highlighting disappears. 

Press Flip to get to the back of the page. 

Press Paste, and the commands are ready to be made into a procedure. 


Oh ge le 


a °°? Flip Side 
CG 

SETBG 5 

REPEAT 40 [FORWARD 40 RIGHT 117 





Add 
TO DESIGN 
and 


END 


and you have a procedure to create a design. 


TO DESIGN 
CG 
SETBG 5 


REPEAT 40 [FORWARD 40 RIGHT 117 





Flip the page and type 
DESIGN 


and the design will appear on the page. 


FROM ANYWHERE TO ANYWHERE 


There are many places where the ability to move text can be useful. Here is a list of some ways not previously mentioned 
that you might want to use Select, Cut, Copy, and Paste. You may not be completely ready for this list yet, but you should 
return to it from time to time as you learn more about LogoWriter. In time, all these ideas will become quite useful to you! 


* Move a copy of a procedure from the flip side of a page to the front so that you can see the procedure and its effect at the 
same time. This can be useful if you are explaining how a procedure works to someone else. 

¢ Move the commands from a procedure to the Command Center so that you can run them one at a time by putting the 
cursor on the first line and pressing Return/Enter. This can be very helpful in debugging. 
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« Move text written using the word processor into a procedure on the flip side of the page. If you are writing about a 
procedure, this method allows you to check yourself by actually running the lines. 

¢ Move text around in the Command Center. You might want to move several groups of commands together so that you 
can run each line without having to skip lines you no longer want. 

¢ Move blocks of text from one page to another. You might want to move one procedure (or other text) from one page to 
another. Simply copy the text from the first page, go to the Contents page and get the second page, then paste the text 
wherever you want it. 


As you continue to work with LogoWriter, you will find many ways to use these word-processing ideas to assist your Logo 
programming. 


ON THE SHAPES PAGE 


So far, you have used Select, Cut, Copy, and Paste with text. You can use Cut, Copy, and Paste on the Shapes Page as 
well. If you are using Macintosh LogoWriter, the tools you need are on the right side of the Shapes Page. If you are using IBM 
or Apple LogoWriter, then you must use the Cut, Copy, and Paste keystrokes. 


First, try making a copy of a single shape from the Shapes Page. 


1. Goto the flip side of the Shapes Page. 

2. Use Next Screen or Previous Screen to go to a shape of your choice. (This action is the equivalent of using Select with 
text.) 

3. Press Copy. Nothing seems to happen. Actually the shape you selected is now stored in a temporary place in the memory of 
the computer. 

4. Use Next Screen or Previous Screen to go to a blank space/shape on the Shapes Page. 

5. Now press Paste. (You can also paste a “new” shape over one that is already there — but then the “old” shape is gone.) 


You see a copy of the shape you selected. Flip the page. You now have two copies of the shape you chose. Press Esc if you 
want to save this page. 


You can also move a shape from one place to another. 


Go to the flip side of the Shapes Page. 

Use Next Screen or Previous Screen to go to a shape of your choice. 

Press Cut. The shape disappears. 

Use Next Screen or Previous Screen to go to a blank or unwanted space/shape on the Shapes Page. 
Now press Paste. The shape appears again. 


DiS Bi 


Flip your page. You have now moved a shape from one spot to another. Press Esc if you want to save this shape. 
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Sometimes you want shapes that are very much alike. You can make one or more copies of a shape, for example, 


PS -22>2- 
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and then make small changes on the ones that need modification: 
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This avoids the necessity of copying a shape block by block, for example, from graph paper. 


Using Cut, Copy, and Paste with shapes is powerful but potentially dangerous. Before you do much experimenting, be 
sure you have a Shapes Page to work with that doesn’t have anything important on it. Then spend some time practicing. Only 
through practice will you find this process easy enough to be useful. 


Keep in mind that when you press Esc, the Shapes Page you are working with is saved on the disk in the disk drive. It is 
easy to accidentally erase a Shapes Page you wanted to keep. Think carefully before you press Esc on the Shapes Page. 


Note that in the Macintosh version of LogoWriter, each new page gives you a fresh, unchanged Shapes Page. However, 
you still need to be careful that you don’t accidentally destroy the Shapes Page with the page you are working on. 


Sometimes you want to copy a shape from one Shapes Page to another or from one disk to another. Copy is one “tool” you 
can use to accomplish this. 


Put the disk containing the shape you want to copy in the drive and select Shapes. 
Use Next Screen or Previous Screen to select the shape. 

Press Copy. 

Press Escape. (Be sure you do this before you switch disks or Shapes Pages.) 

Put the disk on which you want the shape in the disk drive. 

Select the Shapes Page. 

Use Next Screen or Previous Screen to move to the place where you want the shape. 
Press Paste. 

Press Esc to save the modified Shapes Page. 


SO00 ON In 


You now have the shape on both disks. 


TIPS AND TECHNIQUES 

There are many ideas in this chapter that will be valuable to you in your future work with LogoWriter. It is important that 
you not only practice the ideas described here but that you also return to this chapter from time to time to review the suggestions 
that were made. Some of the ideas take a bit of practice to learn to use. For example, resist the temptation to continue to retype 
text rather than to learn to use Copy and Paste. The effort put into learning these new techniques will pay off later. 
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When you are moving text or shapes, it is better to use Copy rather than Cut. If you make a mistake in Pasting the text or 
shape, you can always recopy it and try again. If you use Cut, then the shape or text is gone. After you have successfully 
Pasted, then Cut the text or shape you no longer want. 


At the end of each line of text or at the beginning of a blank line, there is an invisible “Return” or “End of Line” character. 
When you use Select, Cut, Copy, or Paste, these characters will be moved about as well. Look at your screen carefully after 
you have selected text and you will see the highlighted character at the beginning of blank lines. 


PROJECT SUGGESTIONS 


Use the word processor to write a couple of paragraphs for another class. Print a first draft. Then use the text-moving 
commands to modify it. Print the final version. 


Write a series of procedures to draw a triangle, square, pentagon, hexagon, and so forth. Use Copy and Paste so that you 
can do as little typing as possible. 


From the Command Center, create an interesting design. Cut the commands from the Command Center to the flip side of 
the page and create a procedure (or procedures) from them. 


Create a demonstration page. Write a procedure to make an interesting design. Then put a copy of the procedure on the front 
of the page along with an explanation that tells how the procedure produces the design. 


Create a series of similar shapes. Perhaps the shape might be a man walking or a bird flying. Use Copy and Paste to begin 
each new shape. 


Try reversing some shapes. For example, you might want a locomotive engine that runs to the left and another that runs to 
the right. A neat trick is to draw the shape on a transparency and then flip the transparency over. Can you use Copy and Paste to 
get your reversed shape started so that you don’t have to enter every block? (If you are using the Macintosh version, you can 
use the built-in tools to accomplish this task.) 
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15. Music 


You have learned to work with text and graphics in LogoWriter. You can also make music! Try typing 
TONE 440 50 
You hear a musical note. Try changing the numbers after TONE. What does each one do? 


Did you discover that the first number is the pitch of the note? The bigger the number, the higher the pitch of the note. The 
second number is the length or duration of the note. The bigger the number, the longer the note is held. 


The duration of a note is measured in 20ths of a second. On the Apple and Macintosh, a duration of 60 is 1 second long. 
On the IBM, a duration of 20 is about 1 second long. That is, on an Apple or Macintosh, 


TONE 440 60 plays for 1 second 
TONE 440 180 plays for 3 seconds 
TONE 440 30 plays for 1/2 second 


To compute the length of a note, multiply the second input to TONE by 1/60 for the Apple or Macintosh and 1/20 for the IBM. 


In Macintosh LogoWriter, the duration is measured in 60ths of a second. To compute the length of a note in Macintosh 
LogoWriter, multiply the second input to TONE by 1/60. 


The frequencies of the notes are the actual frequencies given in vibrations per second. The table below gives the values for a 
number of octaves. 


| Gc | ct | a | ag | 
| 49 52 | 
| 98] 
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881 988 
0 
i 


*This is Middle C 


| 392] 415] 440 [466 | 
| _ 8811] 
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48 





Using this chart, you would play a C scale (the white notes on the piano) for the octave starting with middle C by using the 
following inputs to TONE: 


TONE 262 10 
TONE 294 10 
TONE 330 10 
TONE 349 10 
TONE 392 10 
TONE 440 10 
TONE 494 10 
TONE 523 10 


There are no flats in this scale. If you have music that uses flats, you need to know, for example, that A sharp is the same note 
as B flat. (Black notes on a piano are sharps and flats.) You then use the chart accordingly. 
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Suppose you want to write a program to play a simple tune. You can write a procedure for each of the lines of the song. For 
example, to have LogoWriter play “Three Blind Mice,” you can begin with 


TO THREE.BLIND 
TONE 330 10 
TONE 294 10 
TONE 262 20 
END 


This phrase is repeated twice, so you can write 


TO LINE1 
REPEAT 2 [THREE.BLIND] 
END 


Similarly, the second line can be written as follows: 


TO LINE2 
REPEAT 2 [SEE.HOW] 
END 


TO SEE.HOW 

TONE 392 10 
TONE 349 5 

TONE 349 5 

TONE 330 20 
END 


Can you finish this song? The procedure tree might look like this: 


THREE.MICE 


ae 


LINE.2 LINE.3 LINE.4 


THREE.BLIND SEE.HOW THEY.ALL 





Using some of the words for the song helps you keep track of what procedures play what part of the song. In each of the 
“LINE” procedures above, a phrase of music is repeated, sometimes with the same words, sometimes with different words. 


Even if you are not “musical” you can write music using LogoWriter. With some simple sheet music and a chart to translate 
the symbols on a musical staff into frequencies, you too can be a composer! 


TIPS AND TECHNIQUES 


The TONE command can be used for sound effects as well as music. Experiment with smail and large numbers for the 
frequency to get buzzes— 


TONE 40 100 
and squeaks— 


TONE 7000 20 
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and slowly changing tones— 


TONE 100 1 
TONE 105 1 
TONE 110 1 
TONE 120 1 
TONE 125 1 


The sounds you can make using the TONE command can be quite varied. 


Many people say “Oh, I’m not musical. I can’t use Logo to make music.” In fact, it is much easier to use a computer to 
make music than it is to play the piano or most instruments. To get started, find some beginning instrumental music. You might 
ask the music department in your school for some beginning music in the key of C. Match the notes on the music with the chart 
below. 


A 





When you have identified the notes by name (A, B, C, etc.), use the chart in the first part of this chapter to write the frequencies 
next to each note. You will want to experiment with the length of a “quarter note,” but the following chart shows you the 
relationship among notes. The length of a quarter note is quite arbitrary. However, once you choose the length for a quarter 
note, then you divide the duration by two to get an eighth note, double it to get a half note, and so forth. 
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Now you are ready to enter any song for which you have music. 


The Macintosh version of LogoWriter allows the use of sound resources. See Appendix 11 for details. 


PROJECT SUGGESTIONS 


If you are involved with music outside of this class, pick a piece of music you have sung or played and “teach” LogoWriter 
to play it! 


Writing music in LogoWriter is an excellent way to practice writing modular programs. Select a piece of music and spend 
some time dividing either the written musical score or the words into small, meaningful sections. Each section will then be a 
procedure. Draw a procedure tree for your song. Then, when you write your song you will have an easy-to-debug program 
because you can check each part of the song as you go. (Note that this is using a strict top-down approach to solving the 
problem of writing your song in LogoWriter.) 


Try adding music to a page you have previously created. For example, you might have a birthday greeting that plays 
“Happy Birthday.” 








By now you have done a lot of drawing with the turtle. You know that you can create designs, change colors, and stamp 
lots of different shapes using the turtle. But LogoWriter has more than one turtle. You have seen only turtle number 0. 


When you start LogoWriter, you see the familiar turtle, turtle 0. Now type 


TELL 1 
ST 


and a second turtle appears. Next type 


TELL 2 
st 


TELL 3 
ST 


Now you see all four turtles. They form a square on the screen. The TELL command allows you to talk to whichever turtle 
you want. Now try this: 


TELL 0 
FORWARD 20 


TELL 1 
RIGHT 90 
FORWARD 20 


TELL 2 
LEFT 90 
FORWARD 20 


TELL 3 
FORWARD 20 
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Turtle 3 Turtle 0 





Turtle 2 Turtle 1 
TELL ALL 
SETC 5 
BACK 20 
a 
Notice how each turtle moves only when “spoken to” with the TELL command. Now type 
TELL ALL 
SETC 5 
All the turtles change color. Next type 
BACK 20 
All the turtles move backwards: 
Turtle 3 Turtle 0 
Turtle 2 Turtle 1 
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Now type 


TELL [0 3] 
RIGHT 90 
FORWARD 20 


Now, two of the turtles move: 


Turtle 3 Turtle 0 


Turtle 2 Turtle 1 


TELL [0 3] 
RIGHT 90 
FORWARD 20 
a 





You can talk to any combination of turtles by putting their numbers inside square brackets. Be careful to use square brackets [ 
and ], not parentheses ( and ). 


Now type 


TELL ALL 
HOME 


HOME is a command that sends the turtles back to their starting places. Turtle 0 goes back to the center of the page. The others 
go back to their original places at the comers of the square. 


Try writing a simple procedure, such as 
TO SQUARE 


REPEAT 4 [FORWARD 20 RIGHT 90} 
END 


Then type 


OG 

TELL ALL 
ST 
SQUARE 
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All four turtles draw a square: 


TELL ALL 
st 
SQUARE 

a 





It can be a lot of fun to have all the turtles active at once! However, you should keep in mind as you are working with 
multiple turtles that it doesn’t make sense to use several turtles just because they are available. For example, there is no reason to 
use two different turtles to stamp different shapes on the page. On the other hand, if you want two turtles active at the same 
time, then you need the capability of using more than one turtle. You will leam more reasons for having multiple turtles when 
you learn about animation (Chapter 20). 


Sometimes when you are working with graphics, especially when you have many turtles, you want to get the page back to 
the way it started: a clear page, one turtle, and the original background and pen color. Remember that the LogoWriter command 
is 


RG 


which stands for Reset Graphics. Keep this in mind when you are working with multiple turtles. 


TIPS AND TECHNIQUES 


The most important concept to keep in mind when you begin working with multiple turtles is the meaning of the TELL 
command. TELL “wakes up” a turtle. It does nothing else. TELL does not make the turtle appear. You must type ST. It does 
not make the turtle draw. You must use FORWARD or BACK. It does not tum the turtle. You must use RIGHT or LEFT. 


You also need to keep in mind that a TELL command remains in effect until you use another TELL command. If you use 
TELL [1 3] then turtles 1 and 3 will obey ail turtle commands you use until you “wake up” other turtles with a different TELL 
command. 


Remember that you must use TELL 0 to get the “regular” turtle active again. 


It is easy to become confused when working with multiple turtles. You can lose track of which turtle you are using. WHO 
gives you the numbers of the active turtles. If you type 


SHOW WHO 


then a list of active turtles appears in the Command Center. For example, if you type 
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TELL {1 3] 


and then type 
SHOW WHO 
you see 

[1 3] 


in the Command Center. You can put SHOW WHO in a procedure using multiple turtles to help in your debugging. 


PROJECT SUGGESTIONS 


There are many interesting things you can do with multiple turtles. You can create fascinating patterns by using some or all 
of the turtles at once. Try writing a procedure to create an interesting graphics design. Then have all the turtles draw it at once. 
You may want to write a SETUP procedure that places each of the turtles before they begin drawing. 
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Until now you have been writing Logo code at a rather intuitive level. You have been given no syntax rules as guidelines. 
Instead, you have followed the models given and experimented as needed, trying to understand error messages that appeared 
when you made a mistake. This is the way most people, both children and adults, begin their learning of Logo. Initially, it is 
quite easy to proceed this way. Logo was designed to provide an easy entry point, what Papert calls a “low threshold.” 


However, to have a more complete understanding of the Logo programming language, you need to understand its basic 
Tules of grammar and punctuation. Once you understand these rules, you will find that learning new Logo primitives is easy and 
that you can pick up a technical reference manual for any version of Logo and understand how each primitive works. This level 
of understanding is necessary if you are going to progress beyond the beginning level in Logo programming. Take note that 
everything in this chapter applies to nearly any version of Logo you encounter—it is in no way specific to LogoWriter. 


On the other hand, you can’t expect to completely understand these rules on a first reading—or even a second reading! You 
should return to this chapter of the book from time to time. Gradually you will see how each primitive and concept fits into this 
larger picture. 


LOGO OBJECTS 


There are three kinds of “objects” that make up the Logo language: words, numbers, and lists. These three familiar terms 
have the following technical meanings in Logo: 


word: an ordered collection of characters 
number: a special kind of word that does not have to be quoted 
list: an ordered collection of words and/or lists 


The definition of “word” is not unlike its common meaning in English. However, a Logo word can contain symbols, such 
as &, >, and +. In practice, however, you will most often see Logo words containing just letters, numbers, and periods. 
Usually a space separates two different Logo words. The name of any Logo procedure must be a Logo word. For example, 
SQUARE and MOVE.TO.ROOF are both legal names of procedures. However, a procedure cannot have the name MY 
HOUSE because a space separates the title into two separate Logo words. 


The definition for nwnber given above contains yet another technical term. To quote a Logo object means to cause it to be 
evaluated to itself. That is, nothing changes when Logo encounters a quoted object. For example, if you type 


PRINT "HI 


you are telling Logo to print on the page the result of "HI. Since the quotation mark is the symbol for quoting a word, HI is 
evaluated to itself, and the word HI is printed on the page. If, however, you type 


PRINT HI 


There is no “HI” primitive, so unless you have defined a procedure named HI, Logo is unable to locate anything to evaluate. 
Thus, Logo responds with “I don’t know how to HI” because it finds no procedure named HI. 


This idea of quoting is prevalent both in English and in other programming languages. When you say “The word ‘cat’ 
occurs 10 times in this paragraph” you are referring to the symbols c-a-t, not the soft, furry animal. If you type 


PRINT "Hello there!" 


in BASIC, or 


WRITELN ('Hello there!'); 
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in Pascal, you want the characters between the quotation marks printed exactly as they appear. In English and BASIC, we quote 
using " "; in Pascal, we use''; in Logo, and we use ” before a Logo word and [ ] to surround a Logo list. More information 
about these punctuation marks will be given later. 


Now, think again about the definition of a Logo number as being a special kind of word. In Logo you can type 


PRINT 234 


and the number 234 is printed, exactly as if you had typed 


PRINT "234 


The message “I DON’T KNOW HOW TO 234” does not appear. You don’t have to quote numbers in Logo. This special case 
exists so that Logo can use standard arithmetic notation. That is, you can type 


PRINT 5 + 7 
instead of 
PRINT "5 + "7 


Finally, consider the third term covered in this chapter: list. You may have noticed something strange about its definition. It 
breaks the rule that you were no doubt taught in school about not using the word you are defining in the definition of that word. 
The definition of a Logo list is a special kind of definition. It is a recursive definition; a definition in terms of itself. You will 
learn more about this idea of recursion later. To give you an intuitive feel for what lists look like, here are some examples of 
quoted lists: 


{cat dog rat hat] <—alist of four words 
(23 3 qweklfsoifalko] <—a list of three words 
[cat [dog] rat] <—alist of two words and one list (which contains one word) 


{{cat dog] [rat mouse] [house hat top] ] <—alist of three lists 


LOGO PUNCTUATION 


In the above discussion, there were a couple of punctuation marks used. Let’s formalize their meaning as well as the 
meanings of a couple of others that are frequently used in Logo: 


. <— __ used to quote a word 
{] <~—_ used to quote a list 
() << _ used as grouping symbols, e.g., (PRINT “HELLO “GOODBYE) or PRINT (93 + 75 + 86) /3 


<— used to designate the value associated with a name. 
(This symbol will be discussed in Chapter 26 of this book.) 


Too often when people are learning Logo, they ask questions such as “Should I use brackets or parentheses here?” Perhaps 
you have asked those questions as you were debugging your programs. Initially, this is okay, but as your understanding grows, 
the above question should be rephrased as “Do I want a quoted list or do I want to group some part of an instruction here?” As 
you ask yourself questions when you debug programs in the future, try rephrasing them in terms such as these. Returm to this 
chart to remind yourself what each of these symbols means. Try to refrain from guessing what symbol you should use when 
you get an error message. 
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CATEGORIES OF PROCEDURES 

All procedures in Logo fall into only two categories. You have already leamed that you can describe a procedure either as a 
primitive (something that Logo “knows”) or as a user-defined procedure (a procedure you write). Both primitives and user- 
defined procedures can be subdivided into two groups: commands and reporters (another word for reporter is operation). 


A command is a procedure that causes an effect. 
A reporter is a procedure that “retums” a value to Logo. 


The procedures you have written to date are all commands, but you have used at least one reporter and will be leaming more 
soon. Consider these examples. 


If you type 
FORWARD 50 


the turtle moves forward 50 turtle steps. FORWARD is a command; its effect is to move the turtle the number of steps given as 
input to FORWARD. However, if you type 


RANDOM 50 


Logo responds with “I don’t know what to do with 37” (or some other number less than 50). RANDOM is a reporter. It reports 
the result of evaluating RANDOM 50 “back” to Logo. You must tell Logo what to do with this result. For example, you might 


type 
FORWARD RANDOM 50 


At this point it is important to recognize that every Logo instruction must begin with a command. There can be any number 
of reporters after that command. However, if the first thing in a Logo instruction is a reporter, Logo returns the “I don’t know 
what to do with...” message. If you get that message when you are programming, be sure that the instruction line you are 
working with begins with a command. 


There is a simple way to understand the workings of any procedure, be it a primitive or user-defined. You need only 
answer these four questions: 


Is it a command or a reporter? 

How many inputs does it need? 

What type or kind of Logo object (word, number, or list) must each of the inputs be? 

If the procedure is a command, what is its effect? If the procedure is a reporter, what is its output—what does it report? 


&wWhND 


This series of questions comes from Chapter 2 of Brian Harvey’s book Computer Science Logo Style, Volume 1, published by 
MIT Press. You can read this book if you would like a more thorough discussion of Logo grammar. 


Practice these questions on some primitives or procedures you have written. For example, consider the primitive PRINT. 


It is a command. 

It takes one input, unless it is surrounded by the grouping symbols () . 

It accepts any Logo object: word, number or list. 

Its effect is to place its input on the page at the current position of the cursor and then move the cursor to the next line. 


WN 


Next, look at the primitive RANDOM. 


1. It is areponter. 

2. It takes one input. 

3. Itrequires a number as input. 

4. Itreports a number from 0 to one less than the number input. 


Can you answer these questions for other Logo primitives—or some of your own procedures? 
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SUMMARY 


If you are a bit overwhelmed, don’t worry. These ideas will become clearer as you do more work with Logo. In summary, 
everything in Logo is a word, list, or number. Every procedure, be it user-defined or a primitive, is either a command or a 
reporter. 


There are four kinds of punctuation marks used in Logo: 


" is used to quote a word 

[ J are used to quote a list 

() are used to group parts of an instruction 
: is used to refer to the value of a name 


TIPS AND TECHNIQUES 


The material in this chapter is central to your understanding of Logo. It is unlikely that you fully understand the material in 
this chapter now. Understanding will come, however. Keep in mind that you should use the material in this chapter as 
reference, particularly as you encounter new primitives that you have difficulty understanding. 


In most versions of Logo, including Apple and IBM LogoWriter, a single character can be quoted using the backslash 
symbol (\). Using this symbol allows you to insert special characters into words. For example, you can type 


PRINT [These are parentheses: \(\)] 


so that LogoWriter won’t insert spaces on either side of the parentheses. In Macintosh LogoWriter you must use the veritcal bar 
(|) instead. The vertical bar can also be used to quote more than just a single character. Thus, you can type 


PRINT |These are parentheses: () | 


to get the spaces exactly where you want them. Characters between the vertical bars are treated as a single character string. 


PROJECT SUGGESTIONS 

Select several Logo primitives that you feel comfortable using. Can you answer each of the four questions given at the end 
of this chapter? This is a good activity to do with a friend. Perhaps you could also practice describing each other’s user-defined 
procedures. You can check each other and discuss your disagreements. This kind of activity will help you understand Logo 


grammar much better. 
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18. Using READCHAR 





You have no doubt used a computer program that asked you a question and then gave you a response that depended on 
what you typed. Perhaps it asked for your name and then greeted you by name. Perhaps you chose a number from a menu. 
Programs that you “talk to” are called interactive programs. You can write interactive programs in LogoWriter. 


Recall that LogoWriter has four turtles, numbered 0, 1, 2, and 3. You can write a program that allows the user of the 
program to tell which turtle s/he wants to use. In order to do this, you need to use READCHAR. READCHAR is a reporter. It 
reports to Logo whatever is typed on the keyboard. Try typing 


READCHAR 


Nothing happens. If you look carefully, you see that the cursor in the Command Center either disappears or stops flashing. 
Next press the number 9. LogoWriter responds with 


I don’t know what to do with 9 
(In Macintosh LogoWniter you can abbreviate READCHAR with RC.) 
In the last chapter you learned that each Logo instruction needs to begin with a command. READCHAR is a reporter. When 


you type READCHAR all by itself on a line, Logo first waits for a character to be typed, and then informs you that it doesn’t 
know what to do now. 


Next try typing 
FORWARD READCHAR 
The cursor disappears as before. Again, type the number 9. The turtle moves forward nine steps. READCHAR reported the 


number 9 to FORWARD. FORWARD then used 9 as input. Logo responded by moving the turtle nine turtle steps. (Using the 
ideas from the last chapter, recall that FORWARD is a command and the effect caused by FORWARD is to move the turtle.) 


9 <—— A number is typed on the keyboard. 


READCHAR 


9 <€—— READCHAR outputs the number ot Logo; 
the number becomes input to FORWARD. 


FORWARD < FORWARD uses the number as input and moves 
the turtle the appropriate number of steps. 





Take a few minutes to reread the previous discussion. It refers to many of the new terms given in the last chapter. Perhaps 
you might even want to go back to that chapter and read the definitions of reporter and command again. 
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If you know another computer language, such as BASIC or Pascal, you are more likely to find interactive reporters 
confusing. In both BASIC and Pascal, you have a variable into which you put any value typed on the keyboard. This value is 
then available by using the variable. (More information about such ideas in LogoWriter will be given in Chapters 26 and 35.) 
READCHAR is not a variable. It does not hold the value for later use. Instead, it immediately reports the value to LogoWriter. 
The action of READCHAR can be summarized as follows: 


The cursor in the Command Center disappears or stops blinking. 

LogoWriter waits until a key on the keyboard is pressed. 

The first key pressed is reported by READCHAR immediately. 

If READCHAR has a command in front of it, that command tries to use the character reported. If there is no command in 
front of READCHAR, it reports to LogoWriter, LogoWriter responds with “I don’t know what to do with ....” 


RWN He 


Next look at a use of READCHAR in a procedure: 
TO SEE.TURTLE 
TELL READCHAR 


ST 
END 


Type 
SEE. TURTLE 
The cursor disappears. Then type 1, 2, or 3. One of the turtles appears. Type 


HT 
SEE. TURTLE 


and try a different number. 
Do you see that you can “talk to” any turtle you want by using this procedure? In this case, READCHAR is reporting the 


number typed to the command TELL. TELL then uses the number to “activate” the appropriate turtle. When LogoWriter 
encounters the ST command, the active turtle appears. 


30 <———— A number is typed on the keyboard. 


| READCHAR 


39 <—— _ READCHAR outputs the number ot Logo; 
the number becomes input to TELL. 


<<} TELL uses the number as input and moves the 
turtle the appropriate number of steps. 





You could also use READCHAR to change the color of the turtle’s pen. For example, type 


TO PICK.COLOR 

PRINT [WHAT COLOR DO YOU WANT?] 
SETC READCHAR 

END 
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Or to pick a turtle shape, type 


TO PICK.SHAPE 

PRINT [WHAT SHAPE DO YOU WANT?} 
SETSH 10 + READCHAR 

END 


Notice that in the last example, the only shapes that can be selected are numbers 10 through 19. READCHAR can accept only 1 
digit: 0 through 9, so adding 10 gives you 10 through 19. 


Here’s a more elaborate example: 


TO MAKE.SQS 
SET .UP 
WHICH. TURTLE 
SQUARE 

END 


TO SET.UP 
CG 


TELL ALL 
HT 
END 


TO WHICH. TURTLE 

PRINT (Which turtle do you want?] 
TELL READCHAR 

st 

END 


TO SQUARE 


REPEAT 4 [FORWARD 50 RT 90] 
END 


When you type 
MAKE .SQS 
the message 
Which turtle do you want? 


appears, and you can then type the number of the turtle you want to draw a square. As before, READCHAR reports to TELL. 
TELL activates the turtle. (The effect of TELL is to activate a turtle.) Then the turtle appears. Finally, the active turtle follows the 
directions in the procedure SQUARE. 


Notice the SET.UP procedure in this program. It makes sure that all of the turtles are hidden before you begin. It is a good 
idea to include a procedure to make sure the page is the way you want it before you start a program. Sometimes that means 
using only RG, sometimes it means using CT and CG, and sometimes you have to worry about a number of turtles. 


Later you will learn other ways to write interactive programs and other ways to use READCHAR. You should take some 
time now to be sure that you see how READCHAR works. While you are practicing, verbalize the ideas about commands and 
reporters that are used in this chapter. As you do so, your understanding of Logo grammar will increase. 
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TIPS AND TECHNIQUES 


Keep in mind that you will never have READCHAR on a line by itself. Every Logo instruction must begin with a 
command, and READCHAR is a reporter. READCHAR must report a value to a command. 


You can only read one character at a time with READCHAR. Don’t try to read numbers with more than one digit or to read 
words with more than one character when using READCHAR. Later you will learn reporters that can be used to read words or 
lists (Chapter 23). 


READCHAR does not save the value you type. Think of READCHAR as a “funnel” between the keyboard and a Logo 
command. If you use a funnel to pour liquid from one container to another, there is no liquid left in the funnel when you are 
finished. If you use READCHAR to move a character from the keyboard to Logo, there are no characters “left in 
READCHAR.” 


PROJECT SUGGESTIONS 


Write a multiple turtle program of your own that allows the user to tell which turtle s/he wants to use. You can have the 
turtle make elaborate or colorful designs. 


Write a program that asks the user what color background s/he wants to use before drawing a design. 
Write a program that asks the user what color the pen should be before drawing a picture of some kind. 


Write a program that allows the user to set the turtle to any of the shapes from 0 to 9. (Later you will learn how to enter 
two-digit numbers.) 


Select any procedure you have used that includes READCHAR. See if you can draw a diagram like the ones in this chapter 
to picture the action taking place in your procedure. 
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19. Indefinite Repetition 


Whenever you want to repeat some action in LogoWriter, you use the REPEAT command. REPEAT is followed by the 
exact number of times you want the action to happen. So, if you want to draw a figure with 6 sides, a six is placed after the 
REPEAT. You must know exactly how many times you want an action to occur when you use repeat. This is sometimes called 
a definite loop. 


Looping is a powerful idea in computing. Computers can do repetitive tasks endlessly without tiring. However, sometimes 
you do not know exactly how often you want an action to occur. For example, you might not know exactly how many people 
turned in ballots to be tallied. Or, you might not know how many people got overtime this pay period. You might have a design 
that you want to appear on the page until the user stops the program. There are many examples in real life of indefinite loops. In 
this chapter, you will take the first step towards learning to construct loops in Logo that can be used to repeat some action an 
unknown number of times. To begin, you will learn to create loops that go on forever. 


Suppose you have the following procedure: 
TO DRAW 
SETC RANDOM 6 
FORWARD 50 


RIGHT 177 
END 


If you type 


DRAW 


and then move the cursor up and run DRAW again a number of times, a “fluffy ball” design begins to form. 
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You could then write the procedure 


TO DESIGN 
REPEAT 50 [DRAW] 
END 


to create the “fluffy ball.” You need to do some experimenting until you get just the right number after REPEAT to produce the 
design you want. 


An interesting effect occurs if you repeat the procedure DRAW over and over and over as different colors change randomly. 
It is quite easy to have this procedure repeat an indefinite number of times. You can write 


TO DRAW 

SETC RANDOM 6 
FORWARD 50 
RIGHT 177 
DRAW 

END 


Now when you type DRAW, the effect goes on and on. 


Do you see what is happening? Use Stop keys (see Appendix 8) to stop the procedure DRAW. (In Macintosh LogoWriter, 
you can also click on the “S” found at the right side of the Command Center.) 


Procedure DRAW is called. 

A random pen color is picked. 

The turtle goes forward 50 “turtle steps.” 

The turtle turns right 177 degrees. 

Procedure DRAW is called—but this is the same as Step 1! 


MmWhWD 


Thus procedure DRAW calls procedure DRAW indefinitely! Procedure DRAW contains a call to itself; it is said to be recursive. 
The command DRAW just before the word END is referred to as the recursive call to procedure DRAW. This is an example of 
the simplest kind of recursion, called tail recursion. You will leam more about recursion later in this book (Chapter 21). 


Here’s another idea to try. Suppose you want to leave a dramatic message on the computer screen as a reminder to a friend. 
You could write a recursive procedure to accomplish this task: 


TO REMIND 

PRINT [Don’t forget the dance on Saturday!] 
PRINT [] 

WAIT 10 

REMIND 

END 


Now, if you type REMIND, the message will continue to appear over and over until someone presses the Stop keys. 


Infinite loops are fun to use to get flashy effects—but they are not particularly useful in and of themselves. The fact that a 
procedure can call itself is a powerful idea. Not all computer languages allow recursion; for example, BASIC doesn’t. You will 
learn how to use recursion to build more practical loops later on in this book. 


One word of “warning” is in order now. For now, when you write recursive procedures, be sure that recursive calls are 
always the last line before END. Recall that this is called tail recursion. Otherwise, Logo is never able to get to the end of your 
procedure and you may get some very unexpected results. For example, write 
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TO OOPS.DRAW 
SETC RANDOM 6 
FORWARD 50 
OOPS . DRAW 
RIGHT 177 

END 


If you run this procedure, you will no longer get a “fluffy ball.” This procedure functions as follows: 


1. Procedure OOPS.DRAW is called. 

2. Arandom pen color is picked. 

3. The turtle goes forward 50 “turtle steps.” 
4. Procedure OOPS.DRAW is called. 


Logo is never able to get to the RIGHT 177. The procedure does not run as you expect. This placement of OOPS.DRAW before 
the end of the procedure OOPS.DRAW is called embedded recursion. You will learn more about it later (Chapter 21). In the 
meantime, keep in mind that your recursive procedure calls should always be just before the END of the procedure. 


TIPS AND TECHNIQUES 


The important idea in this chapter is looping. For now, the infinite loops you can write using recursion are not really useful. 
It is better not to try to use them in programs at this point. Instead, simply practice the idea so that you understand that a 
procedure can call itself. 


Embedded recursion can cause many bugs in programs. Be very careful when you start using recursive calls in programs. 
Make sure the recursive call is on the last line of the procedure. Nothing should be after the recursive call if you are using tail 
recursion to build loops. 


You can build loops that use several procedures. For example, you can write 


TO DRAW. LINES 
FORWARD 50 
RIGHT 177 
CHANGE . COLOR 
END 


TO CHANGE .COLOR 
SETC RANDOM 6 
DRAW. LINES 

END 


DRAW.LINES is still a tail-recursive procedure call. Most likely you would write the above as one procedure. However, if 
your procedures get very long or complex, you may want to subdivide them. Then the recursive call to the “first” procedure is 
on the last line of the “last” procedure. 


PROJECT SUGGESTIONS 

Create a procedure that has an interesting effect. You might display a flashy graphic design, play a line of music, or create 
some mixture of graphics or sounds. Turn your procedure into an indefinite loop. Next, make your procedure part of a larger 
program, but make sure your looping procedure is the last procedure you use in your program. Otherwise, your program will 
never get beyond your procedure containing your indefinite loop! 


a 
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20. Animation 





No doubt you have seen computer programs that have objects moving across the screen. If you have played video games, 
you often see objects, characters, or space ships in constant movement. Using what you know about making shapes and about 
looping, you can write procedures to cause movement on the page. 


Begin by starting LogoWriter and getting a new page. Type these commands: 


PU 
SETSH 25 
FORWARD 2 


Use the Arrow keys to repeat the last command a number of times. The helicopter moves slowly to the top of the page. (Use 
SETSH 10 in Primary LogoWriter.) You can put this in a program that includes an indefinite loop: 


TO LIFT.OFF 
SET.UP 
GO.UP 

END 


TO SET.UP 
OG 

PU 

SETSH 25 
END 


TO GO.UP 

FORWARD 2 

WAIT 2 <— This statement keeps the helicopter from moving too fast. 
GO.UP 

END 


This program has some problems because the helicopter ends up wrapping around the bottom of the page. It looks like it is 
flying right through the ground! Perhaps a better approach would be to modify the SET.UP procedures as follows: 


TO SET.UP 

CG 

PU 

SETSH 25 

RIGHT 90 <-— This line is changed. 
END 


Now try the FLY procedure. The helicopter moves to the right. You can easily change the speed at which the helicopter 
moves. Make the number after WAIT larger. Make it smaller. (You can use decimals.) If you just use FORWARD by itself, you 
have no control over the speed. Take some time to experiment with these ideas. You should become comfortable changing the 
inputs to both WAIT and FORWARD to adjust the speed of animation. 


The movement of the helicopter involves only one shape. Animation of the sort you see in cartoons and in many computer 
programs often involves a changing of the shape as it moves. You can do this in LogoWriter by creating several shapes. 
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Go to the Shapes Page and define Shape 1 as shown below. 


an Eaeen an 
SRE SRE SRE 
Shape 1 (Apple) Shape 1 (IBM or Commodore) Shape 1 (Macintosh) 





Using the Copy keys, copy this shape. Move to Shape 2 with Next Screen. Use the Paste keys to paste it in place. Modify 
Shape 2 so that it looks like this: 





SERRE 
BREESE 
Shape 2 (Apple) Shape 2 (IBM or Commodore) 


Repeat this process used to get shape 2 in order to create Shape 3. 





Shape 3 (Apple) Shape 3 (IBM or Commodore) Shape 3 (Macintosh) 


When using the Apple or IBM versions, you can check the effect of this animation by using Next Screen and Previous 
Screen quickly in succession. Go to Shape 1. Press Next Screen twice quickly and then press Previous Screen twice quickly. 
Repeat this several times, and you will see the effect of your animation without leaving the Shapes Page. 
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Now press Esc and go to your page. Write this procedure on the flip side: 


TO FLAP 
SETSH 1 
WAIT 2 
SETSH 2 
WAIT 2 
SETSH 3 
WAIT 2 
SETSH 2 
WAIT 2 
SETSH 1 
WAIT 2 
FLAP 
END 


Now type 


FLAP 
Do you want the bird to flap its wings faster or slower? If so you can change the numbers after the WAIT commands. 


To make the bird move as well as flap its wings, add some FORWARD commands: 


TO FLAP 
SETSH 1 
FORWARD 1 
WAIT 2 
SETSH 2 
FORWARD 1 
WAIT 2 
SETSH 3 
FORWARD 1 
WAIT 2 
SETSH 2 
FORWARD 1 
WAIT 2 
SETSH 1 
FORWARD 1 
WAIT 2 
FLAP 

END 


Now type 


PU 
RIGHT 90 
FLAP 


To make the bird fly faster or slower, you can change the numbers after the WAIT or the FORWARD commands. Then you can 


really make the bird fly by writing this procedure: 
TO FLY 


REPEAT 20 [FLAP] 
END 
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If you want the flying to continue indefinitely, you can write this procedure: 
TO FLY.FOREVER 
FLAP 


FLY. FOREVER 
END 


Press the stop keys to stop the flying. 


It is fun to combine music and animation, but it is more complex than it seems at first thought. Keep in mind that the 
computer can do only one thing at a time. To play music while animation occurs requires some planning and careful 


programming. 


Begin by looking at a simple example. Suppose you would like to have the bird fly while the notes of the scale play. You 
can go back to the FLAP procedure and insert a note between each flap of the wings: 


TO FLY.AND.SING 
TONE 262 10 


TONE 294 10 
TONE 330 10 
TONE 349 10 
TONE 392 10 
TONE 440 10 
TONE 494 10 
TONE 523 10 


A similar technique must be used if you want to animate two different turtles. You must TELL one turtle to move a bit and then 
TELL the second turtle to move a bit. Then you repeat the sequence over and over, alternating between turtles. 


Be careful when writing procedures such as this. It is easy to create very long programs that are difficult to debug. 
Remember to break your procedures into small, meaningful parts. When you have learned more Logo programming, you will 
see that procedures like FLY.AND.SING can be written much more efficiently. 


Using the methods described above, you can create a wide variety of interesting movement—as well as sound. Animation is 
a lot of fun and can add interest to any project. With the ability to create the shapes of your choice, your projects are limited only 
by your own creativity. 


TIPS AND TECHNIQUES 


By now you are writing increasingly complex programs. As mentioned above, you should always keep your procedures 
short and give them meaningful names. This makes debugging easier. 


Another helpful hint for debugging is to make sure each procedure works by itself. Don’t always type the name of the top- 
level procedure and run the entire program. Run each procedure and make sure it works. Run the entire program only when you 
are sure that all of the parts work. 


When you have a lot of procedures, it is easy to lose track of the action of each procedure. One way to keep track of which 
procedure is running is to put PRINT statements in each procedure. For example, 
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TO FLY 
PRINT [IN PROCEDURE FLY] 
REPEAT 20 [FLAP] 

END 


prints the words “IN PROCEDURE FLY” each time the FLY procedure is called. This gives you a trace of the action of the 
program. Putting in PRINT statements will slow down the action of your program and clutter your screen. However, it will 
help you see what is happening as your program runs. 


PROJECT SUGGESTIONS 
Create a street scene with houses and trees and have a car driving down the street. Perhaps you could add some sound 
effects as well. 


Draw a picture of an airport and have an airplane flying by or perhaps a helicopter landing—or both! (Hint: Use REPEAT to 
land the helicopter and then use recursion to have the airplane continue to fly overhead.) 


Define a number of shapes and create your own animated movie. Be careful to plan your program carefully so that none of 
your procedures get too long! How about adding a sound track to your movie? 
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21. Creating Definite Loops 


So far when you have written procedures with recursive calls to repeat an action, you needed to use the Stop keys to 
interrupt the program. This is not very useful if you want the program to stop automatically or if you want to have the user ask it 
to stop. To stop an indefinite loop, you need to learn about the IF statement. IF is a Logo primitive that allows you to make 
decisions based on some condition. 


Begin by typing 
SETBG 3 
and then type 
SHOW BG 


The number 3 appears in the Command Center. SHOW is a command used to display text in the Command Center. BG is a 
reporter that returns the number of the current background color. Now define this procedure: 


TO CHANGE 
SETBG RANDOM 6 
SHOW BG 

CHANGE 

END 


Type 
CHANGE 


and watch the background color change as the current background color numbers appear in the Command Center. Notice that 
SHOW can be used like PRINT to help debug procedures. (See Tips and Techniques in the previous chapter.) 


Suppose you wanted to change the background color randomly until the background becomes black. Modify CHANGE as 
follows: 


TO CHANGE 

SETBG RANDOM 6 

IF (BG > 0) [CHANGE] 
END 


The condition after IF is “BG > 0.” You can then read the statement as follows: “If the background color is greater than zero, 
call the CHANGE procedure.” 


Examine the IF instruction more carefully. Notice that it is made of three parts: 
1. the word IF 
2. acondition, in this case BG > 0 
3. alist of commands, in this case just CHANGE. 
Logo checks to see if the condition (BG > 0) is true. If it is true, it runs the list of commands, in this case CHANGE. 
When you run CHANGE, you see that the background color changes continuously until it turns black to the background 


color 0. Sometimes the background will change color many times; sometimes not at all. The number of changes depends on the 
number reported by RANDOM. 
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Here’s another way to stop recursion. Suppose you want to ask the user a question, such as “Do you want to see that 
design again?” The following procedure will do just that: 


TO ASK.Q 

DESIGN <— This a procedure that you have defined elsewhere. 
PRINT [Do you want to see another design?] 
IF (READCHAR = "Y) [ASK.Q] 

END 


The three parts of this IF statement are: 
1. The word IF 


The condition: READCHAR = “Y 
The action to take if the condition is true: ASK.Q 


Wh 


Thus, this procedure: 


* runs a procedure called DESIGN, which is defined on the flip side of the page 
* prints a message on the page: “Do you want to see another design?” 
* checks to see if the character reported by READCHAR isa Y. 

If the character is a Y, the procedure ASK.Q is called. 

If the character is not a Y, Logo goes to the END and stops. 


Notice that the character Y is preceded by a quotation mark ("). Without the quotation mark, Logo would look for a 
procedure called Y. READCHAR reports a word made up of one character. You must quote the Y for Logo to compare what 
READCHAR reports with the letter Y. (This might be a good time to review the ideas discussed in Chapter 17.) 


You will learn more about using IF later. For now, you can begin to use it to stop simple recursive procedures. 


TIPS AND TECHNIQUES 


When the condition after an IF statement is true, the list in the IF statement is run. When the condition is false, the next 
statement in the procedure is run. Later you will learn how to have two different actions happen in the IF statement: one when 
the condition is true; another when it is false. 


The punctuation in IF statements can cause some trouble. Keep in mind that there are three parts to the IF statement. The 
word IF has no punctuation. The condition is the second part and may contain some punctuation, such as parentheses. The third 
part is the list of actions to run. This list is surrounded by square brackets. This can be confusing if you have a PRINT 
statement after the IF. Consider this example: 


IF (BG = 0) {PRINT [THE BACKGROUND IS BLACK.]] 
The statement 


PRINT [THE BACKGROUND IS BLACK. ] 
has brackets around it when used in the IF statement. That means there are two square brackets at the end of the IF statement. 


The condition in an IF must return “true” or “false.” One way to see if your condition is functioning correctly is to copy it 
into the Command Center and run it by itself. For example, if you put 


BG > 0 
in the Command Center, then Logo responds 
I don't know what to do with true 


or 
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I don't know what to do with false 


If the message on your screen is not one of the two statements above, then you have written your condition incorrectly. 


Apple and IBM LogoWriter don’t have a “not equal” sign. If you wanted to say “If the background is not equal to 0, call the 
procedure CHANGE” you would write 


IF NOT (BG = 0) [CHANGE] 
Simply put the word NOT in front of the = sign. (In Macintosh LogoWriter, use <> for “not equal.”) 


When using standard math symbols such as >, <, and = in conditions, it is a good idea to use parentheses surrounding the 
condition. This has to do with the way Logo “parses” or translates the words you type so the computer can understand them. 


Inserting PRINT or SHOW into procedures using IF statements can be very helpful in debugging. For example, 


TO CHANGE 

SETBG RANDOM 6 

SHOW BG 

IF (BG > 0) [CHANGE] 
END 


causes the number of the background color to appear in the Command Center before it is tested in the IF statement. Because this 
happens so fast, you might also want to insert a WAIT command: 


TO CHANGE 

SETBG RANDOM 6 

SHOW BG 

WAIT 5 

IF (BG > 0) [CHANGE] 
END 


Be sure to put the PRINT or SHOW commands before the recursive call. 

PROJECT SUGGESTIONS 
Write a program that randomly changes the pen color and draws a design in that color until black is picked. 
Write a program that displays a message on the page over and over until the user types something other than Y. 


Write a program that randomly picks the shape of a turtle and stamps it on the page until the turtle shape (0) is picked. 
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22. Printing Text on the Screen 


You have seen how to put text on the page by using the PRINT command. You have also seen that SHOW can be used to 
put text in the Command Center. PRINT and SHOW are two of the four ways to put text on the screen in LogoWriter. In this 
chapter you will now see how each of the four commands works. 


First, recall that PRINT must be followed by something to print. Whatever follows PRINT must be quoted. That is, it must 
have a quotation mark in front of it if it is a word, or be enclosed in square brackets if it is a list. The input to PRINT then 
appears on the page. Here are some examples of PRINT: 


PRINT “HELLO 
PRINT [This is an example using PRINT.] 


PRINT "Yes 


This is an example using PRINT. 
Yes 
& 





Also note that when you use PRINT, the cursor moves to the next line after the input is printed. 


There is another command that allows you to put text on the page. This command is INSERT. It works exactly like PRINT 
except that the cursor does not move to the next line after the input is printed. Here are some examples of INSERT. 


INSERT “HELLO 
INSERT [This is an example using PRINT.] 


INSERT "Yes 


If you type these commands one after the other, the three inputs shown above will appear one after the other: 


HELLOThis is an example using PRINT. Yes 





Notice that the cursor remains on the same line when you use INSERT. 
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The other two commands for printing text are TYPE and SHOW. Both of these put text in the Command Center. TYPE 
works much like INSERT. That is, the cursor remains on the same line after the command is run. This can give unexpected 
results. Suppose you are in the Command Center and you type 


TYPE [FORWARD 100} 
Then 
FORWARD 100 


appears. If you press Return/Enter, the turtle moves forward 100 steps. 


TYPE [FORWARD 100] 
FORWARD 100 





Pressing Return/Enter here causes the turtle to move. 


You need to be especially careful when using TYPE. 


You have seen SHOW briefly before. SHOW will become particularly helpful as you work towards understanding Logo 
grammar better. SHOW prints its input in the Command Center, including any square brackets. This allows you to tell if the 
input to SHOW is a Logo word or a Logo list. For example, 


SHOW "HELLO 

produces 

HELLO 

while 

SHOW [This is an example] 
produces 


(This is an example] 
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Being able to tell whether you have a word or a list is helpful as you begin to do more work with Logo lists. However, if 
you simply want to put a question in the Command Center, you don’t want to use the square brackets. A clever combination of 


TYPE and SHOW can solve your problem: 
TO COMMAND .CENTER.Q 

TYPE [Here is my question] 

SHOW “™ 

END 


TYPE presents the question without brackets; SHOW followed by a quotation mark prints an empty word, that is, a word 
containing no characters. Another clever solution uses the Logo primitive CHAR which you have seen once before: 


TO DIFFERENT. WAY 

TYPE (Here is my question] 
TYPE CHAR 13 

END 


Every character on your keyboard has an associated number the computer uses to represent that character. This number is called 
its ASCII value. The number 13 is the ASCII value of the Return/Enter key. CHAR takes an ASCII value as input and reports 
the corresponding character. Thus CHAR 13 reports the Return/Enter character and TYPE prints it, moving the cursor to the 
next line. 


Notice that all four of these commands need one input. However, there are times when you want them to have more than 
one input. You can eliminate the second TYPE statement in the above example by surrounding the line containing TYPE with 
parentheses: 


(TYPE [Here is my question] CHAR 13) 


The parentheses tell Logo that there is more than one input to TYPE. Here is another example: 
TO ASK. INITIAL 
PRINT [What is your first initial?] 


(PRINT READCHAR [is a nice initial.]) 
END 


If you type 

ASK. INITIAL 

and then press S, Logo will print 
S is a nice initial. 


In this example, PRINT has two inputs: the character that READCHAR reports and the list [is a nice initial.] When you have 
more than one input for these commands, be sure the first parenthesis goes before the command and the last parenthesis goes 
after the last input. 


TIPS AND TECHNIQUES 


If you are writing interactive programs, using TYPE and SHOW to display questions for the user provides an excellent way 
to keep your page from being cluttered with text. 


If you are debugging a program that uses PRINT as part of the program, try using SHOW to help with the debugging. 
Suppose you have 
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TO DRAW 

DESIGN 

PRINT [Do you want to see the design again?] 
IF (READCHAR = "Y) [DRAW] 

END 


You might insert 


TO DRAW 

DESIGN 

PRINT [Do you want to see the design again?] 
SHOW [JUST BEFORE IF IN DRAW] 

IF (READCHAR = "Y) [DRAW] 

END 


so that the diagnostic messages appear in the Command Center and don’t get mixed up with the output from the program. 


Similarly, you could use PRINT to diagnose problems in a program using SHOW for output. 


PROJECT SUGGESTIONS 


Take some time to experiment with each of these commands. Make sure you understand how each works so that you will 


know which one to use if you are writing a program of your own. 
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23. More on Interactive Programming 


You have learned how to use READCHAR to accept a single character from the keyboard. With it, the user can interact with 
the program. For example, 


TO PICK.COLOR 

PRINT [What background color do you want?] 
SETBG READCHAR 

END 


allows the program user to select the background color. 


LogoWriter has two other primitives for writing interactive programs: READLIST and READLISTCC. Both are reporters. 
Both accept a list from the keyboard. Recall that a Logo list is a collection of words and/or lists. Anything you type can be 
accepted using either of these two new reporters. 


USING READLISTCC 
READLISTCC reads a list from the Command Center. Here is an example: 


TO GREET 

CT 

PRINT (What is your name?] 

(PRINT [Glad to meet you, ] READLISTCC) 
PRINT [] 

PRINT [What is your favorite color?) 
(PRINT [I like ] READLISTCC [too!]) 

END 


If you type 

GREET 

then 

What is your name? 

appears at the top of the page. If you type 

George 

notice that George appears in the Command Center. Then, on the page you see 


Glad to meet you, George 


What is your favorite color? 
In the Command Center, suppose you type 


blue 


Then, 


I like blue too! 


appears on the page. 
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The procedure Glad to meet you, George 


produces these 
sentences. What is your favorite color? 
I like blue too! 
| 
a a ay oe ee 
The user of the program GREET 
types these lines. GEORGE 


blue 
| 





Look carefully at the illustration above. Using READLISTCC allows you to accept responses that are not typed on the page. 


USING READLIST 


READLIST works differently from READLISTCC in that it accepts words and lists from the page rather than the Command 
Center. The following example is like the first one using READLISTCC. Take some time to be sure you see the difference: 


TO GREET 

ct 

INSERT (What is your name?] 

(PRINT [Glad to meet you, ] READLIST) 
PRINT [] 

INSERT [What is your favorite color?] 
(PRINT [I like ] READLIST [too!]) 
END 


When you type 

GREET 

the page clears and 

What is your name? 


appears, with the cursor on the same line. Remember that INSERT leaves the cursor on the same line on the page. Suppose you 
type 


George 


On the page, you then see 
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What is your name? George 

Glad to meet you, George 

What is your favorite color? 

The cursor stays on the same line. Suppose you type 
blue 


Then you see 


What is your favorite color? blue 
I like blue too! 


The user of the program 
types these words. 


What is your name? George 
Glad to meet you, George 


What is your favorite color? blue 
I like blue too! 
a 





The user of the program 
types this line. — >| GREET 
| 


Look carefully at the illustration above. Compare this output with that produced by GREET using READLISTCC. Do you see 
that what is typed appears on the page twice when you use READLIST, but it appears once on the page and once in the 
Command Center when you use READLISTCC? 


CREATING READWORD PROCEDURES 


You have learned to use READCHAR to accept single-character words entered by the user at the keyboard. Those single- 
character words could be numbers. (Recall that a number is a special kind of word.) You have also learned to use READLIST 
and READLISTCC to accept lists from the keyboard. However, sometimes you want to use a single word or a number that has 
more than one character. 


If you want to work with words of more than one character, you can’t use either READCHAR or 
READLIST/READLISTCC. READCHAR will return only the first character you type. READLIST and READLISTCC retum a 
list, not a word. There are several ways to solve this problem. Perhaps the simplest is to write a couple of special procedures 
and save them as tools to be loaded whenever you need them. 
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Get a New Page from the Contents Page and enter these procedures: 


TO READWORD 

OUTPUT FIRST READLIST 
END 

TO READWORDCC 


OUTPUT FIRST READLISTCC 
END 


Save this page, perhaps as READWORD. Then, when you want to use these procedures on another page, you can type 
LOAD “READWORD 


LOAD adds procedures from the page READWORD to your current page. Don’t worry about the “inner workings” of the 
READWORD and READWORDCC procedures for now. You will learn about OUTPUT in Chapter 31. FIRST will be 
discussed in Chapter 38, near the end of this book. 


Using these procedures, you can now work with words and numbers. Here, for example, is a procedure for drawing 
designs interactively: 


TO DRAW 

(TYPE [How far forward?] CHAR 32) 
FORWARD READWORDCC 

(TYPE (How much right turn?] CHAR 32) 
RIGHT READWORDCC 

DRAW 

END 


If you type DRAW, you see 

How far forward? 

Note that CHAR 32 puts a space after “forward?” to make the output more readable. If you type 
50 

the turtle will move forward 50 steps. Then you see 

How much right turn? 

If you type 

90 


the turtle will tum right. Then the questions are repeated over and over until you press the Stop keys. This procedure makes a 
nice “drawing utility” for beginners. 


Using READWORDCC you can create a very simple guessing game, for example, 


TO GUESS 

PRINT [] 

INSERT [Guess a number: ] 

IF NOT (READWORDCC = 7) [GUESS] 
END 


When you type GUESS, the program asks you to guess a number. It continues to ask you to guess until you type 7. Notice the 
IF statement. The condition after IF is 


NOT (READWORDCC = 7) 
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Recall that Logo checks to see if the number typed is equal to 7. If it is, then (READWORDCC = 7) is equal to “true.” The 
NOT reverses that to “false” and Logo moves to the next line of the procedure, encounters END, and stops. If READWORDCC 
is not 7, then (READWORDCC = 7) is equal to “false” and the NOT reverses that to “true” and the procedure DRAW is called 
again. 


TIPS AND TECHNIQUES 

You already know how READCHAR works. Don’t become overwhelmed by the new primitives in this chapter. There is 
very little difference between READCHAR and the new reporters in this chapter. They only extend the ideas you have already 
learned. READLIST/READLISTCC and READWORD/READWORDCC are simply “funnels” between the keyboard and Logo. 


When you use READCHAR, the cursor disappears and you can’t see what is typed. When you use 
READLIST/READLISTCC or READWORD/READWORDCC, the characters typed on the keyboard appear either on the page 
or in the Command Center. 


Don’t worry about understanding how READWORD or READWORDCC works at this point. They are reporters that really 
should be part of LogoWriter but were omitted to save memory. Use them exactly as you would READCHAR or READLIST. 
Just remember to LOAD them onto your page when you want to use them. 


When do you use READCHAR? When do you use READWORD or READWORDCC? When do you use READLIST or 
READLISTCC? The answers are really quite easy. Use READCHAR when you want to accept only one character from the 
keyboard and/or don’t want the user to have to press Return/Enter. Use READWORD or READWORDCC when you want to 
accept a number (or perhaps a single word) from the keyboard. Use READLIST or READLISTCC in ail other cases. 


PROJECT SUGGESTIONS 


Take some time to experiment with these interactive reporters. Write some simple interactive programs using READLIST, 
READLISTCC, READWORD, and READWORDCC. Be sure you can use each one appropriately. Also, use the different 
forms of the text output commands PRINT, INSERT, SHOW, and TYPE. Practice making the text on the page or in the 
Command Center easy to read and understand. 


23. More on Interactive Programming 109 


24. Working with Pages 


You have been working with pages since your first experiences with LogoWriter. You have created pages and saved them. 
You have gotten pages you made earlier and worked with them. There are a number of LogoWriter commands you may not 
have encountered for working with pages. 

First, review the commands you already know. 


¢ NAMEPAGE (NP) “page.name gives the current page a name. 
¢ LOAD “page.name loads the procedures from “‘page.name” and adds them to the procedures on the current page. 


In addition, remember that 
¢ Esc saves the current page under the name at the top of the page. 
Take a few minutes to experiment with any of these that you have forgotten how to use. 


Now for some new commands. Get a new page and name it TEMP1. Then, in the Command Center, type 


CONTENTS 


The current page (TEMP1) is saved and you see the Contents Page: 


Use up and down arrows to choose a page 
and press Return 


NEW PAGE 
SHAPES 


HELP 
TEMP 1 





Select TEMP1. You see your newly created page. You can type CONTENTS rather than press Esc any time you want to go to 
the Contents Page. 


Sometimes you want to get another page, but you don’t remember the names of the pages on your disk. You can type 
PRINT PAGELIST 
and the list of pages appears on the page, or 
SHOW PAGELIST 


and a list of the pages appears in the Command Center: 
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SHOW PAGELIST 
[TEMP1 HELP] 
3] 





PAGELIST is a reporter that returns the list of all the pages on the disk in the disk drive without leaving the current page and 
going to the Command Center. 


Sometimes you want to remove a page you no longer want from the Contents Page. There are two ways to do this. Go to 
the Contents Page, move the cursor down to the page TEMP1, and press Erase to End of Line (See Appendix 9). The page is 
erased permanently. 


Create the page TEMP] again by getting a new page and naming it TEMP1. Press Esc to save it, get another new page and 
name it TEMP2. From the Command Center, type 


ERPAGE “TEMP1 
Go to the Contents Page and you see that TEMP] is gone. 


Create page TEMP1 again. You should now have TEMP] and TEMP2 on your Contents Page: 


contents 
Use up and down arrows to choose a page 


and press Return 


NEW PAGE 


SHAPES 


HELP 
TEMP1 





Get page TEMP1 from the Contents Page. Then, in the Command Center, type 


GETPAGE "TEMP2 


or 


GP “TEMP2 


Notice that TEMP! is automatically saved, and TEMP2 is loaded in its place. TEMP2 is now the current page. You do not need 
to go to the Contents Page to get another page. 


When you are finished working with a page and want to get a new one, you do not have to return to the Contents Page. 
You can use NEWPAGE. NEWPAGE saves the current page and gets a new page. When you type 


NEWPAGE 


you sec the ??7s at the top of the page. This is the same thing that happens when you get a new page from the Contents Page. 
You can also clear a page completely by using CP, Clear Page. This clears both sides of the page, thus removing all the 
procedures from the back of the page. Be very careful when using this command. If you type 
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CP 


and then press Esc, you save a completely blank page. This erases anything that was previously saved on the page, including 
the procedures on the flip side of the page. CP can be very dangerous! 


There is even a command for flipping the page. Instead of using the Flip keys, you can type 


FLIP 


in the Command Center. Notice, however, that when you type FLIP to get to the back of the page, the cursor is in the 
Command Center instead of on the page. 


If you are using LogoWriter Version 2.0 or above, then you can load shapes from any Shapes Page without leaving the 
current page. If you are using Apple or IBM LogoWriter, then type 


GETSHAPES 


in the Command Center, and the Shapes Page from the disk in the disk drive is loaded into memory. If you are using GS or 
Macintosh LogoWriter, then type 


GETSHAPES "page.name 


and the shapes from the page “page.name” are loaded into the current Shapes Page . If you are using Macintosh LogoWriter, 
then you can also use GETSOMESHAPES. GETSOMESHAPES takes two inputs. The first input is the name of the page on 
which there are shapes you want to get; the second is the numbers of the shapes on that page. Thus, if you type 


GETSOMESHAPES "MY.PAGE [2 5 13] 
then shape numbers 2, 5, and 13 on the current page are replaced by shape numbers 2, 5, and 13 from MY.PAGE. 


If you are using a more recent version of LogoWriter (2.0 or above), there are still more commands that help you work with 
pages. For example, the primitives LOADPIC and SAVEPIC allow you to load and save the front of a page. The primitives 
LOADTEXT and SAVETEXT allow you to load and save the text on a page. For more details on these and other useful 
primitives, see Appendix 6 and Appendix 11. These more recently added primitives also provide you with the capability of 
exchanging LogoWriter graphics and text files with other software. For more details, see Appendix 7. 


TIPS AND TECHNIQUES 


Make an effort to learn to use the commands in this section. They can save you a lot of time. For example, getting a new 
page by typing NEWPAGE is much faster than pressing Esc to save the current page, returning to the Contents Page, and then 
selecung NEWPAGE. 


Any of the commands in this section can be used in procedures. Thus, you can be sure that the correct Shapes Page is in 
memory by including GETSHAPES in your SET.UP procedure, for example, 


TO SET.UP 
GETSHAPES 
cT 
RG 
END 


PROJECT SUGGESTIONS 


Take some time to experiment with these new commands and reporters. Will some of them make your work with 
LogoWriter simpler? Become comfortable with these new commands and reporters so you can casily usc them in the future. 
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25. More on Making Decisions 


You have used the IF command to write procedures that branch. You use IF when you want to make a decision within a 
procedure. Two things can happen when you use IF. Either the condition after the IF is true or it is false. If the condition is true, 
the list of commands in the IF statement is run. If the condition is false, Logo moves to the next instruction in the procedure. 


Do these commands 
condition if the condition 
is true. 


Otherwise, continue with the next command in the procedure. 





Have you ever wanted to write a procedure that causes Logo to take one action if the condition after the IF is true and 
another if the condition is false, and then go to the next statement in the procedure? The command that allows you to do that in 
LogoWriter is IFELSE. 


IFELSE works like this: 


Do these commands 
if the condition 


is true. 





You have seen several examples using IF to ask the user whether or not to repeat some action. IFELSE makes it possible to 
make such a procedure more “user friendly”: 


TO SEE.DESIGN 

DESIGN <—This is a procedure to draw some kind of graphics. 

PRINT (Another design?] 

IFELSE READCHAR = "Y [SEE.DESIGN} [PRINT [0.K. Goodbye, then!]] 
END 


If the user types Y, the design appears again. If any other key is typed, then the message 


O.K. Goodbye, then! 


appears. 
Suppose you want to write a program to allow the user to choose from a menu, for example, 


TO MENU 

PRINT [1.See a picture] 

PRINT [(2.Answer a question] 

IFELSE READWORD = 1 [PICTURE] [ASK.QUESTION] 
END 


—|[~SS[S]—_—_——~—~~——SS====[{Z[a=a=aux—D—__{a=_=_=_=_anhDnD=E==|========================== 
25. More on Making Decisions 115 


Then, when you type 
MENU 


you can choose which action you want to take. Notice that if you pick 1, then procedure PICTURE is run. The only choice that 
makes the condition (READWORD = 1) true is the number 1. If any other key is pressed, READWORD = 1) is false. Thus, 
pressing any key except the “1” key causes ASK.QUESTION to run. Even if the user types the wrong key, the question is 
asked anyway! You will learn how to avoid this problem in Chapter 28. 


Did you note that READWORD is used in the procedure MENU? Recall that you have to write a procedure READWORD or 
READWORDCC in order to accept numbers from the keyboard: 


TO READWORD 
OUTPUT FIRST READLIST 
END 


TO READWORDCC 
OUTPUT FIRST READLISTCC 
END 


You can use IFELSE to make various choices within a procedure, for example, 


TO DESIGN 

SETBG RANDOM 6 

IFELSE (BG < 3) [DRAW.STAR]) [DRAW.TRIANGLE] 
SETSH 10 + RANDOM 21 

IFELSE (SHAPE > 20) [MOVE.UP] [MOVE.RIGHT] 
END 


Here, the design that appears on the screen depends on the numbers picked by RANDOM. First a random background color is 
picked. If the color number is 0, 1, or 2, then a star is drawn. If it is 3 or greater, then a triangle is drawn. Next a random shape 
number (between 10 and 30) is picked. If the number is greater than 20 (SHAPE is a reporter that returns the number of the 
current shape), then the turtle is moved up; otherwise, it is moved to the right. 


Examine carefully what happens in a procedure with an IFELSE. When Logo encounters the IFELSE, it first tests the 
condition. If the condition is true, the first list after the condition is run. If the condition is false, the second list after the 
condition is run. Only after one of these lists is run does Logo continue with the next line of the procedure. 


TIPS AND TECHNIQUES 


In all the examples in this chapter, there is one command in each of the lists after an IFELSE. There can be more than one 
command, for example, 


IFELSE (READWORD = 1) [FORWARD 50 RIGHT 90] [BACK 50 LEFT 90] 


It is acceptable to put a few statements in each list after an IF or IFELSE. However, if those lists get very long, then the IF or 
IFELSE statement gets quite hard to read. It is better to write a separate procedure for each list. For example, the above 
statement might read 


IFELSE (READWORD = 1) [GO.FD] [GO.BK] 
where 

TO GO.FD 

FORWARD 50 


RIGHT 90 
END 








116 25. More on Making Decisions 


TO GO.BK 
BACK 50 
LEFT 90 
END 


would be found on the flip side of the page. 


Even a rather short IF or IFELSE statement can become hard to read if it wraps to the next line. It is better to use the word- 
processing capabilities of LogoWriter to format such statements. For example, the above IFELSE statement would be easier to 
read if you wrote 


IFELSE (READWORD = 1) 
[FORWARD 50 RIGHT 90] 
(BACK 50 LEFT 90] 


Keep in mind that Logo procedures are run one line at a time. That is, when Logo is running one line of a procedure, it does 
not “know” what the next line of a procedure will be. When you are debugging procedures, you might consider using an index 
card to cover the lines below the one you are reading. Perhaps this technique will help you avoid the common error of assuming 
that the procedure does what you want it to do instead of what you told Logo to do. 


When using an IF or an IFELSE statement to build a loop, be particularly careful that you don’t accidentally introduce 
embedded recursion. Embedded recursion is a little harder to see when you are using IFELSE. The recursive call must be the 
last statement to run. Consider this example: 


TO EXAMPLE 
PRINT [This is a demonstration] 
IFELSE (READCHAR = "“"Y) 
[EXAMPLE CT] 
{PRINT [BYE] ] 
END 


This procedure has embedded recursion. Each time the user types Y, EXAMPLE is run again, but CT is not run. When the user 
types something other than Y, the PRINT [BYE] is run. Although it would be very difficult to tell, CT is then run as many times 
as the user typed Y. (Try replacing CT with a PRINT statement.) This problem can be corrected by changing the procedure as 
follows: 


TO EXAMPLE 
PRINT [This is a demonstration] 
IFELSE (READCHAR = "“"Y) 
{CT EXAMPLE] 
[PRINT [BYE] ] 
END 


Now, EXAMPLE is the last statement run if the user types Y, and the procedure is now tail recursive. 


PROJECT SUGGESTIONS 


You have written programs using IF. Perhaps you could have used an IFELSE statement to add some action to your 
program. Go back to one of the programs that used IF and modify it by using IFELSE to make it more powerful or interesting. 
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26. Procedure Inputs 


Have you ever made a design out of similar polygons that differed only in size? For example, have you made a design made 
of squares or triangles of different sizes? Or have you made a square house with square windows? If you needed squares of 
several sizes, then you had to write several square procedures that made the turtle go forward different amounts. Now you are 
going to learn how to use a single procedure to that can be used to draw a square of any size you want. 


To make polygons of different sizes, you use procedure inputs. Procedure inputs are names that stand for values that can be 
changed each time the procedure is used. For example, suppose you write 


TO SQUARE :HOW.BIG 
REPEAT 4 [FORWARD :HOW.BIG RIGHT 90] 
END 


If you type 
SQUARE 50 


then the name HOW.BIG has the value 50 associated with it. Then when FORWARD needs an input, it finds :HOW.BIG. The 
“:”” symbol (called “dots’’) in front of HOW.BIG refers to the value associated with HOW.BIG. 


Another way to think about this is to imagine a box that is created when SQUARE is defined. The box is empty and has the 
word HOW.BIG written on the outside. 


Af 


This "box" is created when 
SQUARE is defined. 





Then, when you type 
SQUARE 50 


the number SO is put in the box. 
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The number 50, from SQUARE 50, 
is put into the box. 


! 


f\__ 50 7% 





Later, when FORWARD finds :HOW.BIG for its input, Logo looks in the HOW.BIG box to get the value to give FORWARD 
as an input. 


A copy of the 50 is then used by FORWARD 
to tell Logo how far to move the turtle. 





You can now use the SQUARE procedure listed earlier to make designs, for example, 


TO DESIGN1 
SQUARE 20 
SQUARE 25 
SQUARE 30 
SQUARE 35 
SQUARE 40 
END 
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DESIGN1 
a 





or 


TO DESIGN2 
SQUARE 30 
RIGHT 10 
SQUARE 35 
RIGHT 10 
SQUARE 40 
RIGHT 10 
SQUARE 45 
END 


DESIGN2 
a 





ee 


26. Procedure Inputs 121 


Whenever a procedure is written using a procedure input, you must always provide the value for the input name when using 
that procedure. For example, if you type 


SQUARE 
and press Return/Enter, Logo will say 
SQUARE needs more inputs 


just as it does when you type FORWARD without an input. Procedures that you write that use inputs behave exactly like Logo 
primitives that use inputs. 


LOOPING USING INPUTS 


You have written procedures that ask the user if s/he wants to see a message again. Using procedure inputs, you can put 
any message you want in such a procedure, for example, 


TO SEE.MESSAGE :MESSAGE 


CT 
REPEAT 5 [PRINT :MESSAGE] 
PRINT [] 


INSERT [Do you want to see the message again?] 
IF READCHAR = "Y [SEE.MESSAGE :MESSAGE] 
END 


To run this procedure, type 
SEE.MESSAGE [Go team! Win this game!] 


You see 
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Win 
Win 
Win 


you want to see this message again? 


SEE.MESSAGE [Go team! Win this game!) 
| 





If you type Y, then the lines of the procedure are repeated. Do you see what is happening? 


¢ The words “Go team! Win this game!” are put in the “box” labeled “MESSAGE.” 


The value "Go team! Win this game!" 
is given to MESSAGE when 
SEE.MESSAGE [Go team! Win this game!] 


is typed. 


J | Go team! Win this game! : 


¢ Next PRINT has as input : MESSAGE, read “dots MESSAGE.” (The “:” symbol can be thought of as “look in the box.”) 





¢ PRINT finds “Go team! Win this game!” in the “MESSAGE box” and prints that value five times on the page. 


¢ Next, the READCHAR causes the procedure to wait for input. If Y is typed, then the “value in the MESSAGE box” is 
sent back to procedure SEE.MESSAGE, using the name MESSAGE. 


You can make this procedure more user friendly by using IFELSE: 
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TO SEE.MESSAGE :MESSAGE 


cT 
REPEAT 15 [PRINT :MESSAGE] 
PRINT [] 


INSERT [Do you want to see the message again?] 
IFELSE READCHAR = "Y 

(SEE.MESSAGE :MESSAGE] 

[PRINT [O0.K., goodbye!]] 
END 


PASSING VALUES FROM THE KEYBOARD TO A PROCEDURE INPUT 
Adding one more procedure makes the program even more user friendly: 


TO ASK.QUES 

PRINT [What message do you want to see?] 
SEE.MESSAGE READLIST 

END 


Now, whatever is reported by READLIST is put in the MESSAGE box when SEE.MESSAGE is called 


ASK.QUES 

WHAT MESSAGE DO YOU WANT TO SEE? 
wow!!! 

a 


This value is accepted by READLIST. 


WOW!!! is reported to SEEAMESSAGE. 


WOW!!! becomes the value of MESSAGE. 


ng 


J womttt 7 
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and is then used by the procedure SEE.MESSAGE: 


WOW!!! becomes the input to PRINT and 
is displayed five times on the page. 


J wows 7 


MES SAGE 





This last example contains a lot of new ideas: 


« Anonnumeric value is associated with an input. 
¢ The value of the input is “passed back” to the procedure, using the input name. 
¢ A value is “passed to” the input name using READLIST. 


You will learn more about these ideas in coming chapters. For now, take a few minutes to study the example carefully. You will 
likely need to read this example several times before you begin to understand it. 


CREATING A CASE STATEMENT 


Earlier you encountered the problem of creating a menu with two items by using IFELSE. If you run the procedure MENU 
below, all is well if you select either 1 or 2, but if you type any other number, the ASK.QUESTION procedure runs, even 
though that is probably not what you want to happen: 


TO MENU 

PRINT [1.See a picture] 

PRINT [2.Answer a question] 

IFELSE READWORD = 1 [PICTURE] [ASK.QUESTION] 
END 


Sometimes you want a procedure to allow multiple choices and, in addition, to do nothing at all if an incorrect choice is 
made. To accomplish this task, you must write a more elaborate program. Suppose you have the following menu procedure: 


TO SHOW.CHOICES 

PRINT [1. See a square] 
PRINT [2. See a star] 
PRINT [3. See a triangle] 
END 


You can then create a procedure to handle all of the choices: This type of structure is called a CASE statement: 


TO WHICH.ONE :CHOICE 


IF :CHOICE = 1 [SQUARE STOP] 
IF :CHOICE = 2 [STAR STOP] 

IF :CHOICE = 3 [TRIANGLE STOP] 
END 


Now you can write 


TO MENU 

SHOW. CHOICES 
WHICH.ONE READCHAR 
END 


—=—<===—S'SS*==_—_—H—__E_E_[_E—ESS>S>>S>>>—EE——SSESES—E—SE——L— LL ======_=_=_=_==_=an=|=|=|=[a[[=[{_______{ajz_aqan=ananana==== 
26. Procedure Inputs 125 


Think about how this procedure works. 


- First the menu is displayed on the page. 

¢ Then the procedure WHICH.ONE is called. 

¢ READCHAR waits for input from the keyboard and passes the valued typed into the name CHOICE in procedure 
WHICH.ONE. 

¢ CHOICE is then tested by each IF statement. If there is a match, then the appropriate list of commands is run. 


The STOP statement is not usually necessary in this case structure. However, if you have a lot of choices, it prevents the 
procedure from running through all possible matches listed in the procedure. STOP causes only the procedure in which it is 
located to stop running. 


TIPS AND TECHNIQUES 


There are a lot of new ideas in this chapter. If the idea of procedure inputs is new to you, then start with simple 
procedures like the ones for drawing polygons. Only when you understand these simple procedures should you try to write 
procedures with inputs that use interactive reporters and/or conditionals (IF and IFELSE). 


The model used for procedure inputs in this chapter is boxes containing values. The value of this model is that it is easy 
to draw and explain. However, it has a serious flaw. A Logo name can be associated with only one value. That is, the “box” 
can contain only one value. However, boxes in the real world can contain more than one item. Furthermore, when you pass a 
value to another name, it is still associated with the original name. A copy is passed. But when you take something out of a 
rcal world box, it is gone. Be careful that you don’t take the model of values put into boxes too literally. Keep in mind that a 
Logo name can hold only one value and that it passes a copy of that value to another name. 


Using PRINT statements in procedures that use inputs can be very helpful in debugging. For example, you can use a 
PRINT statement to verify the value of an input: 


TO SQUARE :HOW.BIG 

(SHOW [THE VALUE OF HOW BIG IS] :HOW.BIG) 
REPEAT 4 [FORWARD :HOW.BIG RIGHT 90] 

END 


You can keep track of how often a procedure is run with a given input: 


TO SEE.MESSAGE :MESSAGE 
(SHOW [BEGINNING OF SEE.MESSAGE WITH VALUE] :MESSAGE) 


CT 
REPEAT 5 [PRINT :MESSAGE] 
PRINT [] 


INSERT [Do you want to see the message again?] 
IF READCHAR = “Y [SEE.MESSAGE :MESSAGE] 
END 


or verify what value was passed to a procedure: 


TO WHICH.ONE :CHOICE 
(PRINT [THE VALUE PASSED TO CHOICE IS J] :CHOICE) 


IF :CHOICE = 1 [SQUARE STOP] 
IF :CHOICE = 2 [STAR STOP] 

IF :CHOICE = 3 [TRIANGLE STOP] 
END 


Using PRINT or SHOW to trace the action of your procedures can save you a lot of debugging time. This is a case where you 
should let Logo do some of the debugging work for you. 
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PROJECT SUGGESTIONS 


Write procedures to draw a design made up of squares and triangles of all sizes. Be sure you use an input and write only 
one SQUARE and one TRIANGLE procedure. 


Write a program that asks the user what size design s/he wants to see. Then draw the design, using what the user types as 
input. 


Write a procedure with more than two menu choices. Are you sure all of the possibilities work as you intend? Test your 
program carefully. 


Think about a procedure to draw a triangle. You use REPEAT 3 followed by some commands. To draw a square, you use 
REPEAT 4. What would you use to draw a five-sided figure? Can you write a procedure to draw a figure with any number of 
sides using an input? What angle will you tum? (Hint: The turtle must turn 360 degrees to get back to where it started.) 





27. More on Multiple Turtles 


You have used multiple turtles. Recall that you can have several turtles active at once, all doing the same thing. The turtles 
are numbered 0, 1, 2, and 3. 


Turtle 3 Turtle 0 


Turtle 2 Turtle 1 





You saw that 


TELL number or list.of.numbers 


tells which turtle or turtles should become active. 


There are several other LogoWriter primitives used with multiple turtles. Sometimes when you are working with more than 
one turtle, you forget which turtles are active. That problem is easily solved with WHO. Recall that WHO is a reporter that 
retums the numbers of the active turtles. Thus, if you type 


TELL [1 3] 

and then later in your work you forget which turtles are active, you can type 
SHOW WHO 

and LogoWriter will display 

(1 3) 


in the Command Center. 


———SS ee 
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Another useful command is EACH. EACH is followed by a list of other commands for the active turtles to run. If you type 


TELL ALL 
st 

TELL [3 1) 
SQUARE 20 


then turtles 3 and 1 draw a square at the same time (assuming you have defined a procedure SQUARE.) 
You see 


st 
TELL [3 1] 
oe 20 
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However, if you then type 


OG 
EACH [SQUARE 20] 


you see 


CG 
EACH [SQUARE 20] 
a 





followed by 


CG 
EACH [SQUARE 20] 
a 





Turtle 3 draws a square, and then turtle 1 draws a square. Notice the difference. If you issue other commands after a TELL, 
all the active turtles move at once. If you use EACH followed by a list of commands, the turtles move one at a time. 
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A third useful command is ASK. ASK needs two inputs: a turtle number or list of turtle numbers, and a list of commands. 
It allows you to address either an active or an inactive turtle. First type 


TELL ALL 
ST 

TELL [1 3] 
SQUARE 20 
SHOW WHO 


you see 





Turtles 1 and 3 draw a square because they are made active by TELL. 
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Next type 


ASK 2 [BACK 20] 
SHOW WHO 


i 


ASK 2 [BACK 20] 
SHOW WHO 
a 





ASK communicates with turtle 2, and instructs it to move back 20 turtle steps. However, the list of active turtles is unchanged. 
Only TELL changes the list of active turtles reported by WHO. Finally type 


ASK 1 [TRIANGLE] 
SHOW WHO 


‘ 


ASK 2 [TRIANGLE] 
SHOW WHO 
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This time ASK causes turtle 1 to draw a triangle, but the active list is not changed. Take a few moments to study this example to 
be sure you understand what is happening. 


Using these new commands and interactive commands, you can write an interactive program to make the turtles dance. 
First, you need a dance procedure: 


TO DANCE 

REPEAT 20 [FORWARD 1 LEFT 18 WAIT 1] 
REPEAT 20 [BACK 1 RIGHT 18 WAIT 1] 
REPEAT 10 [FORWARD 1 WAIT 2] 

REPEAT 10 [BACK 1 WAIT 2] 

REPEAT 20 [FORWARD 1 RIGHT 18 WAIT 1] 
REPEAT 20 [BACK 1 LEFT 18 WAIT 1] 

END 


Next, you need to place the turtles in a row on the screen: 


TO SET.UP 
RG 

cT 

TELL ALL 
PU 

st 

TELL 1 
FORWARD 40 
RIGHT 90 
FORWARD 40 
LEFT 90 
TELL 2 
FORWARD 40 
LEFT 90 
FORWARD 40 
RIGHT 90 
END 


Now for the main procedure, 


TO ASK.QUES 
SET .UP 
ASK.USER 
END 


and the ASK.USER procedure: 


TO ASK.USER 

PRINT [] 

INSERT (Which turtles do you want to do a dance?] 

TELL READLIST 

PRINT [] 

INSERT [All at once or separately? (A=All at once S=Separately) ] 
IFELSE READCHAR = "A [DANCE] [EACH [DANCE] ] 

PRINT [] 

INSERT [Which turtle would you like to see dance a solo?) 
ASK READCHAR [DANCE] 

PRINT [] 

INSERT [Would you like to see some more dancing?] 

IF READCHAR = "Y [ASK.USER] 

END 
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Using a procedure input, you could even change the speed of the dance: 


TO DANCE :SPEED 

REPEAT 20 [FORWARD 1 LEFT 18 WAIT :SPEED] 
REPEAT 20 [BACK 1 RIGHT 18 WAIT :SPEED] 
REPEAT 10 [FORWARD 1 WAIT 2 + :SPEED] 
REPEAT 10 [BK 1 WAIT 2 + :SPEED] 

REPEAT 20 [FORWARD 1 RIGHT 18 WAIT :SPEED] 
REPEAT 20 [BACK 1 LEFT 18 WAIT :SPEED] 

END 


Then, you could replace each DANCE in ASK.USER with ASK.DANCE: 


TO ASK.DANCE 

INSERT [How fast should the dance be?) 
DANCE READCHAR 

PRINT [J 

END 


What other modifications might you make to this program? How about asking the user what color each turtle should be? How 
about asking about the background color? 


Macintosh LogoWriter also includes the primitive TOUCHING? This primitive is used to tell if one turtle is touching 
another one. For example, 


SHOW TOUCHING? 2 3 


retums “‘true” if turtle 2 is touching turtle 3. Similarly, with TOUCHING? you can see if one turtle is touching any of the others 
in a list of turtles. Thus, 


SHOW TOUCHING? 2 [1 3] 


retums “true” if turtle 2 is touching either turtle 1 or turtle 3. The first input to TOUCHING? is a number, the second can be a 
single number or a list of numbers. 


TIPS AND TECHNIQUES 


The differences among TELL, EACH, and ASK can be confusing at first. Here is a brief summary to help you understand 
each command. 


¢ TELL sets up the list of active turtles. 
¢ EACH causes the list of active turtles to perform some action. 
¢ ASK ignores the list of active turtles and directs any turtle or turtles to perform some action. 


Why do you need each of these statements? 


¢ TELL is used to change the list of active turtles. It has no other function. Turtle commands given after a TELL command 
cause all the turtles listed after TELL to do those commands at the same time. 

¢ EACH is used if you want the turtles to perform some action one at a time. 

¢ ASK is used to give direction to turtles not in the active list. For example, you might “ASK” a nonactive turtle to return 
its color, shape, or heading. 


The ASK.USER procedure in this chapter combines a lot of ideas you have learned in previous chapters. It is also a good 
example of the kind of procedure where inserting PRINT or SHOW statements can help in debugging. Here is the ASK.USER 
procedure with a number of possible diagnostic statements inserted that might help in the debugging: 
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TO ASK.USER 
SHOW [AT THE BEGINNING OF ASK.USER] 
PRINT [] 
INSERT [Which turtles do you want to do a dance?] 
TELL READLIST 
SHOW WHO <—This shows which turtles are now active 
PRINT [] 
INSERT [All at once or separately? (A=All at once S=Separately) } 
IFELSE READCHAR = "A 
{SHOW [A SELECTED] DANCE] 
[SHOW {A NOT SELECTED] EACH [DANCE] ] 
PRINT [)] 
INSERT [Which turtle would you like to see dance a solo?) 
ASK READCHAR [(SHOW [TURTLE PICKED IS] WHO) DANCE] <—WHOvwused inside the ASK statement 
PRINT [] returns the turtle active at that moment. 
INSERT {Would you like to see some more dancing?] 
IF READCHAR = “Y [ASK.USER] 
END 


Take a few moments to examine where the diagnostic statements have been added. Learning to put such statements into useful 
places takes practice and is part of the art of debugging. 


PROJECT SUGGESTIONS 


Write an interactive program using multiple turtles and inputs. Perhaps you could have the turtle draw geometric shapes or 
draw different colored designs. Start with a simple idea and expand it as you work. 


——————————— 
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28. Using Inputs to Pass Values Among Procedures 


You now know how to write procedures with inputs. You can write a single procedure to draw squares of any size or print 
a variety of messages. You also know how to send a value typed by a user to a procedure with an input. However, what if you 
want to send a value typed by the user to several procedures? For example, suppose you have a procedure that asks the user to 
tell how big s/he wants some polygons or other designs. You can’t write 


TO ASK.QUES 

PRINT [What size polygons?] 

SQUARE READWORD <—Remember, you have to define READWORD. 
TRIANGLE READWORD 

END 


Do you see why? If you type 

ASK.QUES 

Logo puts 

What size polygons? 

on the page. If the user then types 

50 

then a square of size 50 is drawn. Everything seems fine so far. 


Next, the procedure stops and waits for a second input from the keyboard because it encounters another READWORD. But 
you wanted a square and triangle of the same size. The user should not have to type 50 again. 


Here is one way to solve this problem: 


TO ASK.QUES 

PRINT [What size polygons?) 
HOLD .SIZE READWORD 

END 

TO HOLD.SIZE :SIZE 

SQUARE :SIZE 

TRIANGLE :SIZE 

END 


TO SQUARE :HOW.BIG 
REPEAT 4 [FORWARD :HOW.BIG RIGHT 90] 
END 


TO TRIANGLE : LENGTH 
REPEAT 3 [FORWARD :LENGTH RIGHT 120] 
END 


Do you see how HOLD.SIZE works? Examine the procedure tree to help you see the structure of the program. Notice that 
procedure inputs do not appear on the procedure tree: 
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ASK.QUES 


HOLD.SIZE 


ee 


Carefully study the following explanation of how ASK.QUES works. Take special note that the same input name is not 
used in any two procedures. While it is legal to use the same name, keeping the names different helps you to think about what is 
happening to the values of the names as the program runs. It also will help you avoid bugs in your more complex programs in 
the future. 





If you type 


ASK.QUES 

Logo responds with 

What size polygons? 
Suppose you type 

mt) 


50 <—— Typed on the keyboard. 


50 <—— Reported by READWORD to HOLD.SIZE 


HOLD .SIZE 





Then READWORD reports 50 to HOLD.SIZE.HOLD.SIZE needs an input. 50 becomes the input to the HOLD.SIZE 
procedure. Thus, SIZE has the value of 50 in HOLD.SIZE. 
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The value of the input to the procedure HOLD.SIZE 
receives the number reported by READWORD. 


! 


J\_ 50 7 





Next, SQUARE is called in the procedure HOLD.VALUE.SQUARE needs an input. The :SIZE is read “the value in the box 
SIZE.” Logo then “passes” the value associated with SIZE into the HOW.BIG box. 


Logo takes the value of SIZE 
and puts a copy into HOW.BIG. 


oN 


f\_ 39 7 f\_ 30 





In the procedure SQUARE, the instruction 
FORWARD :HOW.BIG 


instructs Logo to look for the “value in the box HOW.BIG” to see how far forward to move the turtle. 
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Logo takes the value of SIZE 
and puts a copy into LENGTH. 


f\_ 50 7 





Finally, the procedure TRIANGLE is called. In a similar manner, Logo copies the value of HOW.BIG into the LENGTH 
box. Now the value of LENGTH is used to move the turtle forward to draw a triangle. 


The above explanation details a rather complex process computer scientists call parameter passing. If you didn’t understand 
it completely, don’t be concerned. As you work with this idea, it will be become clearer simply by modeling it and through 
practice. You should read the explanation several times, and return to it in the future when you encounter similar examples. 
When you can draw the diagrams yourself and explain what is happening, you will have made this idea your own. You will 
then be able to use it in a variety of situations. 


Here is another example. Can you explain what is happening at each step of the process? 


TO GREET 

PRINT (What is your name?] 
HOLD .NAME READLIST 

END 


TO HOLD.NAME :NAME 
PRINT.GREETING :NAME 
SHOW .DESIGN 
SAY.FAREWELL :NAME 
END 


TO PRINT.GREETING :WHO 

(PRINT [Hi,] :WHO) 

PRINT {Here is a neat design.] 
END 


TO SHOW.DESIGN 
(some graphics here) 
END 


TO SAY.FAREWELL :TO.WHOM 

(PRINT [So long, ] :TO.WHOM) 

PRINT [Hope you enjoyed the graphics.] 
END 


Did you conclude that READLIST passes a value to NAME in HOLD.NAME? Then the value of NAME is copied into WHO in 
PRINT.GREETING. Finally, the value of NAME is copied into TO.WHOM to be used in the procedure SAY.FAREWELL. 


Fe 
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Notice that the name of the user is used in the first and last procedure in HOLD.NAME, but not in the design procedure. 
This technique allows you to use a piece of information anywhere you want in a program. 


TIPS AND TECHNIQUES 


The caution about the “box” model in Chapter 26 applies here as well. A Logo name can hold only one value at a time. 
When a value is passed to another name, a copy is passed; the original name keeps the value as well. 


When you begin to use procedure inputs in a number of procedures in your program, it is important that you check each 
procedure carefully to be sure it runs by itself. For example, you can check the HOLD.NAME procedure 


TO HOLD.NAME :NAME 
PRINT.GREETING :NAME 
SHOW. DESIGN 
SAY.FAREWELL :NAME 
END 


by typing something like 

HOLD.NAME “MARY 

and you can check the PRINT.GREETING procedure 
TO PRINT.GREETING :WHO 

(PRINT [Hi,] :WHO) 


PRINT [Here is a neat design.] 
END 


by typing 
PRINT.GREETING "MARY 
If each procedure doesn’t run by itself, then you are probably using procedure inputs incorrectly. 
You should have noticed that a procedure input name is never used in more than one procedure in this book. This technique 


helps you avoid bugs as you learn to use procedure inputs. It forces you to be sure that each procedure works by itself without 
being dependent on the correctness of any other procedure in the program. 


PROJECT SUGGESTIONS 
Draw the diagrams and “boxes” to explain the program GREET. 


Practice writing programs that use a value typed at the keyboard. At first, use the models above, but then see if you can 
develop a program that goes beyond the models given in this chapter. 
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29. Incrementing 








Have you ever wanted to write a program that counted something? Perhaps you wanted the user to say how many times 
s/he wanted a message to appear. Or perhaps you wanted to write a program to see all the shapes on the Shapes Page. You can 
write programs that count by building loops using tail recursion. Begin with this procedure: 

TO COUNT.UP1 :INPUT.VALUE 
PRINT : INPUT. VALUE 
WAIT 5 


COUNT.UP1 :INPUT.VALUE + 1 
END 


If you type 
COUNT.UP1 1 


then Logo responds with 


"WO PWNE 


forever! There is no stop rule. Before thinking about how to stop this procedure, examine carefully what is happening. 


Begin with a value of 1 for INPUT, and substitute values: 


TO COUNT.UP1 1 
PRINT 1 
WAIT 5 
COUNT.UP1 + 1-% TO COUNT.UP1 2 
END PRINT 2 
WAIT 5 
COUNT.UP1 2 + 1-®TO COUNT.UP1 3 


END PRINT 2 
WAIT 5 
COUNT.UP1 3 + 1-> and so forth. 
END 





To stop the procedure at 10, you could add an IF instruction: 


TO COUNT.UP2 :INPUT.VALUE 
PRINT : INPUT. VALUE 


WAIT 5 
IF :INPUT.VALUE < 10 [COUNT.UP2 :INPUT.VALUE + 1] 
END 
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Now the procedure will add one to the input value until it reaches 10. Examine the last several procedure calls. 


Begin with INPUT. VALUE having the value of 8. 


TO COUNT.UP2 8 

PRINT 8 

WAIT 5 

IF 8 < 10 [COUNT.UP2 8 + 1]  (8<10/is true, soCOUNT.UP2 
END is called with 9.) 


TO COUNT.UP2 9 

PRINT 9 

WAIT 5 

IF 9 < 10 [COUNT.UP2 8 + 1] (9<10 is true, so COUNT.UP2 
END is called with 10.) 


TO COUNT.UP2 10 

PRINT 10 

WAIT 5 

IF 10 < 10 [COUNT.UP2 9 + 1] (10<10 is false, so the list is 

END ignored; Logo sees the END 
and stops the procedure.) 





This procedure can now be used in a program that asks the user how high s/he wants to count. 


TO ASK.COUNT 

PRINT [How high do you want to count?) 
COUNT.UP 1 READWORD 

END 


TO COUNT.UP2 :INPUT.VALUE :MAX 

PRINT : INPUT. VALUE 

WAIT 5 

IF :INPUT.VALUE < :MAX [COUNT.UP2 (:INPUT.VALUE + 1) :MAX] 
END 


Notice that the procedure now needs two inputs: the number printed in the procedure and the maximum. 


_ 


, a 


COUNT .UP2 


<— Value reported by READWORD 





When COUNT.UP2 is called in ASK.COUNT, the number 1 is put into the INPUT.VALUE box. The number typed by the 
user (and reported by READWORD) is put into the MAX box. At the end of the procedure, the IF statement checks to see if the 
number input is less than the maximum. If so, then the procedure is called recursively. 
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Look carefully at this recursive call. The first value sent back to COUNT.UP2 is INPUT.VALUE + 1. That is, one is 
added to the initial input so that when the procedure runs again, it runs with a number one larger than the original input. The 
value of MAX is passed unchanged. 


The value of INPUT.VALUE changes... but the value of MAX does not change. 


is | 7 
#\ AEs 


INPUT. VALUE 





Note that the stop rule, (INPUT.VALUE + 1), is in parentheses. The parentheses are not necessary in this case. They are only 
there to make the procedure more readable. 


The programs shown so far count by 1s—that is, 1 is added each time the procedure is called. What if you want to count 
by 5s or 10s? Instead of adding 1 each time, you can add 5 or 10. COUNT.UP3 can be modified as follows to count by Ss: 


TO COUNT.UP3:INPUT.VALUE :MAX 
PRINT : INPUT.VALUE 


WAIT 5 
IF :INPUT.VALUE < :MAX [COUNT.UP3 (:INPUT.VALUE + 5) :MAX] 
END 


Now, instead of adding 1 each time, 5 is added. Can you draw diagrams like those given above to show what is happening to 
the values of each procedure input? 


It is possible to generalize COUNT.UP3 even further by including yet another procedure input to hold the amount to add. 
This procedure becomes even more difficult to follow, but it provides a good exercise for you to see if you understand 
procedures with multiple inputs and passing values. Here, the input TO.ADD holds the value to be added to INPUT. VALUE 
each time: 


TO COUNT.UP4 :INPUT.VALUE :TO.ADD :MAX 
PRINT :INPUT.VALUE 
WAIT 5 
IF :INPUT.VALUE < :MAX 
[COUNT.UP4 (:INPUT.VALUE + :TO.ADD) :TO.ADD :MAX] 
END 


You can take this one step further by allowing the user to input the amount to add: 


TO ASK.COUNT 

PRINT [Type the amount you want to] 
PRINT [add and press Return/Enter.] 
PRINT [Then type the highest number you] 
PRINT [want the program to print, and] 
PRINT [press Return.] 

COUNT.UP4 7 READWORD READWORD 

END 
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Think carefully about what is happening. Now there are three inputs about which you need to be concemed. If you type 
ASK .COUNT 


Logo responds with 


Type the amount you want to 

add followed by Return. 

Then type the highest number you 
want the program to print, and 
press Return/Enter. 


Notice that you must press Return/Enter for each READWORD. READWORD uses the first word in a list that is entered after 
you press Return/Enter. 


If you then type 


5 
35 


COUNT.UP is called with a value of 7 (provided in ASK.COUNT) for INPUT.VALUE, 5 for TO.ADD, and 35 for MAX. 
The diagram below illustrates this concept. 


The value of INPUT.VALUE changes... but the value of MAX does not change. 


| | r 
fl SS Ff Z| 10K 





Can you predict what the output from this program will look like? There is a bug in this program. It does not perform exactly as 
described. Spend some time thinking through each recursive call to the procedure. Can you find the bug? 


One further modification of the procedure allows the user to input the number to start with, namely, the value of 
INPUT.VALUE: 


TO ASK.COUNT 

PRINT [Type the number you want to] 
PRINT [start with followed by Return.] 
PRINT [Then type the amount you want to] 
PRINT [add, and press Return/Enter.] 
PRINT [Then type the highest number you] 
PRINT [want the program to print, and] 
PRINT [press Return.] 

COUNT.UP4 READWORD READWORD READWORD 
END 
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TO COUNT.UP4 :INPUT.VALUE :TO.ADD :MAX 

PRINT :INPUT.VALUE 

WAIT 5 

IF :INPUT.VALUE < :MAX [COUNT.UP4 (:INPUT.VALUE + :TO.ADD) :TO.ADD :MAX] 


END 
Can you draw the diagrams to explain this procedure? 


Notice that the value reported by the first READWORD is put in the INPUT. VALUE box; the value reported by the second 
READWORD is put in the TO.ADD box; and the value reported by the third READWORD is put in the MAX box. Both the 
MAX and the TO.ADD boxes remain unchanged as the procedure runs. As before, only the INPUT.VALUE box changes as the 
amount to add each time is added. 


Now the program is even more flexible. Try running it. This version has the same bug. It doesn’t count as high as it says it 
does. Can you fix this bug? 


USING INCREMENTING 


Incrementing can be used in a variety of settings. Suppose you want to make a “square spiral,” that is, a square in which 
each side gets longer as each side is drawn. You need to add a fixed amount each time you draw a side. This is similar to the 
COUNT.UP programs above. You could write 
TO GROW.SQUARE :SIDE 
FORWARD :SIDE 
RIGHT 90 


IF :SIDE < 80 [GROW.SQUARE :SIDE + 5] 
END 


If you type 
GROW.SQUARE 10 


the turtle draws a side of length 10, then a side of length 15, then a side of length 20, and so forth until the side reaches 80: 


GROW.SQUARE 10 
a 
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How about writing a program to display all the shapes? Recall that 
SETSH 10 


sets the turtle shape to shape number 10. Sometimes it would be helpful to see your shapes without leaving your current page. 
You can write a procedure that steps through the shapes one at a time. You can start with shape number 1 and add 1 until you 
reach your last shape number, say 30. This is similar to the COUNT.UP procedure: 


TO SEE.SHAPES :WHICH.ONE 

SETSH :WHICH.ONE 

WAIT 10 

IF :WHICH.ONE < 30 [SEE.SHAPES :WHICH.ONE + 1] 
END 


When you type 
SEE.SHAPES 1 
you see each shape on the screen briefly. 

You can also use incrementing to count how often something happens, for example, 
TO DRAW.STARS :COUNTER :HOW.MANY 
PLACE.STAR <— a procedure to pick a random location 
STAR <— a procedure to draw a star 
IFELSE :COUNTER < :HOW.MANY 

(DRAW.STARS (:COUNTER + 1) :HOW.MANY] 


([(PRINT [You see] :HOW.MANY [stars!])] 
END 


If you type 


DRAW.STARS 1 20 


this procedure draws 20 stars and then prints on the page that there are, indeed, 20 stars. This seems a bit strange. The program 
simply tells you that you have the number of stars you asked for. You could use this procedure in a different way. By giving the 
name HOW.MANY a random number as input, each time the procedure is run a different number of stars is drawn. Then, 
printing the number drawn doesn’t seem so strange: 


DRAW.STARS 1 (RANDOM 50) 


Here, RANDOM SO provides the input for HOW.MANY and COUNTER keeps track of the number of stars drawn. 
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50 
Some number RAND 
between 0 and 49. = 
. [) e 


DRAWS .STARS 


COUNTER and HOW.MANY get values 
when DRAW.STARS is called. 


’ ’ 
aa! 





Incrementing is a powerful tool. You can find many uses for it in your programs. Whenever you want to keep track of the 
number of times something occurs or you want to repeatedly add the same number, then you need to use the techniques 
explained in this chapter. 


EMBEDDED RECURSION 


When you first learned to construct loops in Logo by using recursive calls, you were cautioned to be sure that the recursive 
call was the last statement in your program or procedure. You saw an example in Chapter 19 in which the last lines of a 
procedure were never run because the procedure simply called itself again and again. In this context, embedded recursion looks 
like it has no particular value at all. It is, however, a powerful tool that is used extensively in more advanced Logo 


programming. 


“Counting” procedures provide a good opportunity to further examine embedded recursion. Consider a modification of the 
simplest COUNT.UP procedure from the beginning of this chapter, renamed now as DO.COUNT: 


TO DO.COUNT : INPUT.VALUE 
PRINT :INPUT.VALUE 
DO.COUNT :INPUT.VALUE + 1 
END 
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Next, modify this procedure so that it includes a stop rule: 


TO DO.COUNT :INPUT.VALUE 

PRINT :INPUT.VALUE 

IF :INPUT.VALUE < 5 [DO.COUNT :INPUT.VALUE + 1] 
END 


This procedure will print the values from 1 to 5 if you enter 
DO.COUNT 1 
Next, make a simple change as follows: 


TO DO.COUNT :INPUT.VALUE 

IF :INPUT.VALUE < 5 [DO.COUNT :INPUT.VALUE + 1) 
PRINT : INPUT.VALUE 

END 


Now if you type 
DO.COUNT 1 


you see 


RS NW AW 


What is happening? Examine the diagram below, which is similar to the one we looked at earlier for COUNT.UP: 


TO DO.COUNT 1 
IF 1 < 5 [DO.COUNT 1 + 1] Qa) 
PRINT 1 
WAIT 5 
END TO DO.COUNT 2 
IF 2 < 5 [DO.COUNT 2 + 1] 
PRINT 2 @) 
WAIT 5 4 
END TO DO.COUNT 3 
IF 3 < 5 [DO.COUNT 3 + 1] 
PRINT 3 G3) 
WAIT 5 
END TO DO.COUNT 4 
IF 4 <5 [DO.COUNT 4 + 1] 
ie @ 
WAIT 5 
END TO DO.COUNT 5 
IF 5 < 5 [DO.COUNT 5 + 1] 
PRINT 5 
WAIT 5 
END 





First, procedure DO.COUNT is called. The number 1 is clearly less than the number 5. Thus, at Step 1 in the diagram, 
DO.COUNT is called with an input of 2. Notice that the PRINT 1 statement is not run at this time. Next 2 is tested against 5. 
The test fails, and DO.COUNT is called with an input value of 3 (at Step 2 in the diagram). This process continues until at Step 
4,5<5 is false. Thus DO.COUNT is not called again, so the procedure moves to the next statement, 
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PRINT 5 


Thus, 5 is printed. Logo runs the WAIT command and then reaches the END of the procedure. Now, the procedure “above” is 
incomplete (Step 5). Logo finishes that procedure by running 


PRINT 4 
WAIT 5 


Now there remains the rest of the PRINT and WAIT statements that were not run, so Logo runs those statements as it 
encounters them until it reaches an END statement, then it moves to the next unfinished procedure that was stacked up waiting to 
be run. 


At first, embedded recursion seems quite mysterious. If you study the above example carefully, you will no doubt see why 
and how it works. However, embedded recursion is probably not something you want to use just now in your programming. If 
you are working with other people learning Logo, you will often see the results of their unwittingly using embedded recursion. 
Embedded recursion is often the reason that a message flashes on the screen again and again when the programmer thought it 
should appear only once. Perhaps the screen flashes at the end of a program for unexplained reasons or there are unexpected 
pauses when a program should just stop. Such effects occur when statements such as CT or CG are placed after a recursive call. 


When you have had more experience, you may want to explore this idea further. For a more complete treatment of 
recursion, see Brian Harvey’s book Computer Science Logo Style, Volume 1, mentioned in the Introduction to this book. 


TIPS AND TECHNIQUES 


The procedures in the first part of this chapter become increasingly complex. If you are new to programming, you may well 
have trouble following the explanations. You can use the ideas you have leamed about debugging to help you understand what 
is happening in a difficult procedure. For example, here is the last version of COUNT.UP, with a couple of PRINT statements 
added to help you understand the procedure: 


TO COUNT.UP4 :INPUT.VALUE :TO.ADD :MAX 
PRINT : INPUT. VALUE 
WAIT 5 
(PRINT [MAX = ] :MAX) 
(PRINT [TO.ADD = ] :TO.ADD) 
IF :INPUT.VALUE < :MAX 
(COUNT.UP4 (:INPUT.VALUE + :TO.ADD) TO.ADD :MAX) 
END 


You might then run this procedure by typing 
COUNT.UP4 5 3 15 


and then you can study the results step by step. Then try changing each of the values to see what happens. Use this technique 
with any procedures that you have trouble understanding. 


PROJECT SUGGESTIONS 


The version of the COUNT.UP4 procedure does not actually print the maximum value, for example, COUNT.UP 3 5 9. 
See if you can fix it so the procedure runs correctly for any values you input. 


Draw appropriate diagrams for the various versions of COUNT.UP. Can you explain the behavior of each of the 
modifications to COUNT.UP? 


Experiment with other types of GROW procedures. Make triangular or hexagonal spirals. What happens if the spirals 
wrap? Can you modify the procedure so that the user can tell how big the spiral should get? How about modifying it so that the 
user can tell how large the space between sides of the spiral should be? 


Modify the SEE.SHAPES procedure so that the number of the shape is printed under the shape. 
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Modify the SEE.SHAPES procedure so that the user can repeatedly specify which shape s/he wants to see. Hint: Add a 
question asking the user if s/he wants to see another shape. 


Write a program containing DRAW.STARS, and use RANDOM as input to it. Perhaps you could have the program stop to 
ask the user to count the stars. Then the program could check to see if the user counted correctly. 

















30. Logo Arithmetic and Math 


Have you discovered that you can do math in Logo? For example, you can type 
PRINT 3 + 4 
and Logo prints 
7 
or you can type 
PRINT (3 * 4) - 10 
and Logo prints 2. 


Notice that the * is the sign that Logo uses for multiplication. Here are examples of the arithmetic and mathematics that 
Logo can do. 


PRINT 20 + 5 Logo prints 25 
Logo prints 15 


Logo prints 100 

Logo prints 4 

RINT REMAINDER 20 5 Logo prints 0 
(The remainder when 20 is divided by 5) 





If you have studied some trigonometry, you can use Logo in these ways: 


PRINT COS 20 Logo prints 0.9396 
PRINT SIN 20 Logo prints 0.342. 


(Note: this is 20 degrees) 





Macintosh LogoWriter includes even more mathematical functions (see Appendix 11). 
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Notice all of these mathematics operations are reporters — they report a value to the PRINT command. For example, you 
can diagram PRINT 20 * 5 as follows: 


5 <— Multiplication needs two inputs. 


) 


100 <—— The result of the multiplication 
is reported to PRINT. 





In math, these are called binary operations because they have two inputs. SIN and COS are unary operations. They have one 
input. Can you diagram SIN 30? 


You have used other arithmetic reporters with IF and IFELSE. The result of =, < or > was reported to IF. 
If 20 < 50 


would be diagrammed as: 


50 <——20 and 50 are compared. 


7 ome 


<<: 


true <—The result is reported to IF. 





All three of these reporters return either true or false. When these are used in IF or IFELSE, the “true” or “false” is reported to 
the conditional. The conditional statement then selects an action based on the result reported (“true” or “‘false”). 


You can print the result of these reporters just as you can print the result of arithmetic reporters. 
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In Macintosh LogoWriter, you can also use <> (not equal), <= (less than or equal), and >= (greater than or equal). 


Using arithmetic reporters and what you know about incrementing, you can easily have Logo generate a table of values. For 
example, 
TO SQUARES :NUMBER : LARGEST 
(PRINT :NUMBER :NUMBER * :NUMBER) 


IF :NUMBER < : LARGEST [SQUARES :NUMBER + 1 :LARGEST] 
END 


If you type 
SQUARES 1 5 


Logo prints 


OWN 
Nr wo her 


6 
5 
Using this idea, you can create multiplication tables or tables of sines easily. 


With the skills you now have in Logo, you can write a simple arithmetic drill-and-practice program. Begin with a procedure 
to print a problem and accept the answer. 


TO SEE.AND.CHECK :NUMBER1 :NUMBER2 
PRINT [] 
PRINT [] 
(INSERT :NUMBER1 [+] :NUMBER2 [=}) 
IFELSE READWORD = (:NUMBER1 + :NUMBER2) 
[GOOD . JOB] 
(TRY.AGAIN :NUMBER1 :NUMBER2] 
END 


Examine the INSERT line carefully. Do you see why it prints the problem and not the answer? How is 
:NUMBER1 [+] :NUMBER2 
different from 
:NUMBER1 + :NUMBER2 
Do you see that in the first line the plus sign is quoted (see Chapter 17)? In the second it is not. That means that the [+] will be 
printed, but when + appears without being quoted, it is treated as a reporter. It reports the sum of the two numbers. This is an 


important idea. Study the above example to be sure you see what is happening. 


The procedures GOODJOB and TRY.AGAIN might look like this: 


TO GOOD.JOB 

CT 

REPEAT 50 [INSERT [Good for you!!!!!! ]] 
END 
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TO TRY.AGAIN :N1 :N2 

PRINT [] 

PRINT [No, try the problem again] 
SEE.AND.CHECK :N1 :N2 

END 


Notice that the numbers are sent to TRY.AGAIN, but not used. They are then sent back to SEE.AND.CHECK so that the same 
problem is printed again. That is, the value of N1 is sent back to SEE.AND.CHECK and becomes the value of NUMBER 1 and 
the value of N2 is sent back to SEE.AND CHECK and becomes the value of NUMBER2. The procedures SEE.AND.CHECK 
and TRY.AGAIN make use of the idea of passing values from one procedure to another that you have seen earlier. 


To get SEE.AND.CHECK to select random problems, you need a statement something like 
SEE.AND.CHECK RANDOM 10 RANDOM 10 


Here, the result from the first RANDOM 10 (a number from 0 to 9) becomes the value of NUMBER1. Similarly, a number 
from 0 to 9 is reported by the second RANDOM 10 to NUMBER2. Each number in the problem shown then ranges from 0 to 
9. Then, a procedure is needed to allow the user to select how many problems s/he wants to practice. 


TO ASK.USER 

PRINT [How many problems do you want to do?] 

REPEAT READWORD [SEE.AND.CHECK RANDOM 10 RANDOM 10] 
END 


Now this program can be used to do arithmetic practice. 


TIPS AND TECHNIQUES 


You have seen that parentheses are often used in an IF or IFELSE statement when the reporters <, >, or = are used. If you 
do not use parentheses, sometimes mysterious bugs appear. This is because the standard mathematical symbols are “infix” 
notation. The symbol goes in between the inputs. That is, we write 3 + 4 or S < 6 rather than +3 4 or < 5 6. All Logo 
commands and reporters use “prefix” notation. That is, the command or reporter comes before the inputs to the procedures or 
primitives. When infix and prefix notation are mixed, it can be difficult for the Logo parser to translate correctly. Parentheses 
force Logo to translate expressions in the way you intend. 


PROJECT SUGGESTIONS 


Write a program to generate a table of values that you might find useful. Format the page nicely, then print the results to use 
elsewhere. 


Can you draw diagrams to explain how values are passed in the SEE.AND.CHECK program? Try explaining the program 
to someone who has never seen this idea before. 


Modify the SEE.AND.CHECK program so that the user can give the range of numbers s/he wants. 


Different versions of LogoWriter have different math reporters available. Some versions include a page called 
MATHTOOL. Get that page and experiment with the procedures found there, or check your manual for a list of math reporters 
that you can use. 
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31. OUTPUT 


You have seen the OUTPUT command in the READWORD procedure that is used. Except for OUTPUT, all of the 
procedures that you have written have been commands. That is, when you typed the name of the procedure, it caused some 
effect—it did not report a value. OUTPUT is the command that allows you to write your own reporters. Procedures containing 
OUTPUT report values. Think about READWORD. If you type 


READWORD 

and then type 

Hello 

Logo responds 

I DON’T KNOW WHAT TO DO WITH Hello 


READWORD reported a value, but you did not tell Logo what you wanted to do with the value. You might diagram this as 
follows: 


Hello 


| READWORD | 


Hello 


v 


"Hello" is reported but there 
is no command to "catch" it. 





READWORD behaves just like other reporters that you have used, like RANDOM. 


Suppose you wanted a procedure that reported the cube of a number. Remember that the cube of a number is that number 
times itself three times. For example 


2=2x2x2=8 


33=5x5x5=125 
You can use OUTPUT to write such a procedure 
TO CUBE :NUMBER 


OUTPUT :NUMBER * :NUMBER * :NUMBER 
END 
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Now, if you type 
PRINT CUBE 5 


Logo prints 125. You can diagram this as follows: 


5 <— CUBE takes one input. 


CUBE < The action taken by CUBE is to 
multiply its input by itself three times. 
1 


25 <—— Theresult reported by CUBE 
becomes the input to PRINT. 





Writing simple reporters can give you your own set of personalized tools to use in other procedures. For example, you can 
create a color “‘tool kit” using OUTPUT so that you don’t have to remember the color numbers. You can write 


TO ORANGE 
OUTPUT 4 
END 


(The procedure assumes the color number for orange is 4.) If you then type 


PRINT ORANGE 


you see the number 4 on the page. Using PRINT with ORANGE lets you see the color number. However, there is another 
way to use ORANGE that makes your programs more readable. You can type 


SETBG ORANGE 


The background of the page turns orange. You can write a series of procedures for all of the color names that you want to use. 
Not only do you not have to remember color names, but other people reading your program can tell what colors you intended to 
use. 


In a similar manner, you can write shapes tools: 


TO CAT 
OUTPUT 21 
END 


and then 


SETSH CAT 
to make the use of shapes clearer. 


You can save groups of procedures, such as a color or shapes tool kit, on a separate page. When you want to use them on 
the page you are working on, you can type 


= 
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LOAD "page.name.with.tool.procedures 
These procedures are then added to the procedures currently on the page. 


LogoWriter has two built in reporters that you have not seen before that give information about the color of the turtle and 
the color of the background. These can be used with a color tool kit to make procedures using them more readable. The first of 


these reporters is COLOR. If you type 
PRINT COLOR 
you see the number representing the current pen color. You can then put a statement such as 


IF COLOR = ORANGE [SELECT.ANOTHER] 


COLOR reports the current color number. ORANGE reports 4. If the current pen color is 4, then the procedure to select 
another color is called. The illustration below diagrams how this works. 


| COLOR ORANGE | 


COLOR reports the current ———> 3 4 <——— ORANGE always reports 4. 


pen color. Perhaps it is 3. / \ 


false <— =reports tue or false only 





COLOR might be used if you have a program to select random pen colors. Perhaps you have an orange background and 
you don’t ever want to select an orange pen. You might write 


TO SELECT .ANOTHER 

SETC RANDOM 6 

IF COLOR = ORANGE [SELECT.ANOTHER] 
END 


Then your program could draw a design in a random color, which you then know will not be orange. 
The other new color reporter is COLORUNDER. COLORUNDER reports the color under the turtle’s pen. You might use 
IF COLORUNDER = ORANGE [YOU.WIN] 


in a game. Perhaps the goal is to land the turtle on an orange circle. This statement checks to see if the color underneath the 
turtle is orange. Note: if you have difficulties with COLORUNDER, you may need to move the turtle a few steps and try 
again. This has to do with the make-up of the screen in some versions of LogoWriter. COLORUNDER reports only the color 
under the pen. Sometimes it is helpful to set the turtle’s shape to a single dot at the center of a shape so that you can see exactly 
where the turtle’s pen is located. 
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In an earlier chapter, you learned to write music using LogoWriter. Writing music might be easier if you made a tool kit. 
For example, you can write 


TO C4 
OUTPUT 262 
END 


TO D4 
OUTPUT 294 
END 

TO E4 


OUTPUT 330 
END 


and so forth. Note that the numbers in the above procedures come from chart given in Chapter 15 of this book. 


You can even write procedures for quarter notes, whole notes, half notes, and so forth. For example, you could write 


TO Q 
OUTPUT 20 
END 

TO H 
OUTPUT 40 
END 

Then you could write 
TO PHRASE1 
TONE E4 Q 
TONE D4 Q 
TONE C4 H 
END 


TO THREE. BLIND 
REPEAT 2 [PHRASE1] 
END 


to play the first two phrases of “Three Blind Mice” in the 4th octave of the scale on the chart! 


In the past if you wanted to write a procedure to calculate the area of a rectangle, you wrote: 


TO AREA :LENGTH :WIDTH 
PRINT :LENGTH * : WIDTH 
END 


Typing 
AREA 8 10 
causes Logo to respond 


80 


As long as you do not need to use the area elsewhere, this works fine. However, what if you want a procedure that makes use 
of the area, perhaps to find the cost of carpet? Then, if you write 


TO AREA :LENGTH :WIDTH 
OUTPUT :LENGTH * :WIDTH 
END 
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you can use the value elsewhere. Thus, you can now type 
PRINT 15 * AREA 8 10 
to find the cost at $15 per square yard of an 8 yard x 10 yard carpet. 


If you are comfortable with mathematical language, you can think of reporters as functions. That is, the AREA procedure 
above is a function that produces the area given the length and width. In Logo terms, it is a procedure which takes two inputs 
and reports the product of those inputs. These are just different ways of saying the same thing. 


Writing procedures like this as reporters allows them to be used in a number of interesting ways. Suppose you want a 
procedure to report the perimeter of a rectangle. 


TO PERIMETER :LENGTH :WIDTH 
OUTPUT (2 * :LENGTH) + 2 * :WIDTH) 
END 


You can then use this procedure to make sure the perimeter of a rectangle is within a certain range. 


TO CHECK.PERIMETER :L :W 
IFELSE (PERIMETER :L :W) < 100 
{ (PRINT :L [and] :W [are 0O.K.])] 
((PRINT :L [and] :W [are too big.])] 
END 


This procedure can be used to plan a fenced-in area for which you had only 100 feet of fencing. Notice that the value of L 
is passed into LENGTH and that the value of W is passed into WIDTH in the PERIMETER procedure. PERIMETER then uses 
the values of LENGTH and WIDTH to produce the value that is reported back to CHECK.PERIMETER by PERIMETER. Can 
you draw diagrams to explain how the reporters function and how the values are passed from input to input? 


Writing your own reporters can be useful both in adding tools to your programs and in making programs more readable. 
When you are writing a program and discover that you want a value computed and then used elsewhere in the program, you 
probably need to use OUTPUT. 


It takes practice to learn to use OUTPUT. At first the idea of a command that turns a procedure into a reporter is a strange 
notion. Start by practicing with simple examples such as the tool kits at the beginning of this chapter. When you feel 
comfortable with them, move to more complex procedures that accept an input and report back an output, such as the CUBE 
procedure. In time you will feel more comfortable with OUTPUT. If you choose to leam more advanced programming in 
Logo, you will find that understanding OUTPUT is an essential part of mastering sophisticated list processing techniques. 


TIPS AND TECHNIQUES 


There are two ways in which OUTPUT is useful at this stage of your programming career. The first is the creation of tool 
kits as described in this chapter. These tool kits are made up of isolated procedures that are not connected with other procedures 
in your program. That is, procedures in a tool kit would not appear in the procedure tree for a program. Instead each procedure 
in the tool kit would have its own single-entry procedure tree. 


The second use of OUTPUT is to create functions to produce some value. Writing procedures such as AREA above allows 
you to name a computation and then use the result of that computation anywhere in your program. In general, these functions 
will be a part of your procedure tree. 


At this point in your Logo programming, you can think of OUTPUT as a method of naming actions or ideas in your 


program. You are giving a name to a color or shape number, or to a computation (such as AREA). Later in your Logo 
programming, you will discover that OUTPUT is the key to sophisticated programming ideas using Logo. 
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PROJECT SUGGESTIONS 
Write your own math tool kit. Create procedures that you might use frequently and put them onto a page of your own 
tools. Be sure you put comments on the page so that it is clear what each procedure is for. 


Use COLOR in a program that selects both the pen color and the background color randomly and draws designs but checks 
to be sure that the background color is not the same as the pen color. (Hint: Remember BG?) 


Use COLORUNDER to create a simple “game.” Perhaps have the turtle move randomly until it lands on a particular color. 
You could have a counter that prints how many moves the turtle makes until it lands on the right color. 


Make a music tool kit. You might use numbers to specify octaves. For example, you could have procedures called C1, 
C#1, D1,...C2, C#2, D2, etc. Caution: If you create too many note procedures you may run out of memory. Write procedures 
for only a couple of octaves. 


Write a procedure to create music with random pitches and durations. How can you keep the pitches or durations above a 
particular number? (Hint: 5 +RANDOM 10 reports numbers from 5 to 14.) 
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32. Moving the Cursor From Procedures 





You have used the word processor to create text on the page. You have also used the Select, Cut, Copy, and Paste keys to 
change both text on the page and procedures on the flip side of the page. All of the things that can be done using key 
combinations on the keyboard can be done from within a procedure. In this chapter you will begin to learn how to manipulate 


text from procedures. 
Use the Up keys and type the text as shown below. 


You can change text using commands 
typed in the Command Center or from 
procedures. 

B 





Press Return/Enter here. 


Now, use the Down keys to return to the Command Center. Type 
TOP 


You see 


Mou can change text using commands 
typed in the Command Center or from 


procedures. 








Next type 





BOTTOM 

You see 
You can change text ; using commands 
typed in the Command Center or from 
procedures. 
| 

Next type 

CU 


The cursor moves up one line. You see 


You can change text : using commands 
typed in the Command Center or from 
Hrocedures. 





Next type 


REPEAT 4 [CF] 


The cursor moves forward 4 characters. You see 


You can change text using commands 
typed in the Command Center or from 
procihures. 





eo 
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You can also move the cursor backwards by typing 





cB 

You see 
You can change text : using commands 
typed in the Command Center or from 
prolikdures. 

Next type 

CU 

Cu 

@ 


The cursor moves up two lines and down one line. You see 


You can change text using commands 
typ@Hi in the Command Center or from 
procedures. 





Next, try 


TOP 
EOL 


The cursor moves to the end of the paragraph, as if you pressed next screen. Type 
SOL 


The cursor moves to the start of the paragraph. Keep in mind that in some versions of LogoWriter, “end of line” means move 
to the next Return character, and start of line means move to the previous Return character, while in other versions, EOL means 
the end of the line on the screen and SOL means the beginning of the line on the screen. 


These cursor commands can be used to add interesting effects to your procedures. Suppose you put the lines of a song on 
the page. For example, you might have 


TO ROW.ROW 

PRINT [ROW, ROW, ROW YOUR BOAT] 
PRINT [] 

PRINT [GENTLY DOWN THE STREAM] 
PRINT [{] 

END 
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Perhaps you would like to have the cursor move to each line and then play the music that goes with these words. So, you might 
have 


TO SEE.AND.SING 

ROW. ROW 

TOP <— Moves cursor to the first line, on the word ROW. 
PLAY.PHRASE1 <— A procedure to play the first phrase. 

cD <—These two commands move the cursor to the word GENTLY. 
cD 

PLAY.PHRASE2 <— A procedure to play the second phrase. 

END 


ROW, ROW, ROW YOUR BOAT 


GENTLY DOWN THE STREAM 
a 





With the ability to move the cursor to the top and bottom of your text as well as one paragraph, one line or one character, you 
can place the cursor wherever you wish after you put text on the page. 


TIPS AND TECHNIQUES 


Each time you press Return/Enter when using the LogoWriter word processor or use a PRINT statement to put text on the 
page, there is an invisible “Return” character at the end of each line. As you are working with these new commands, pay 
attention to the position of the cursor as it moves. If you type 


PRINT [HI] 
and then type 


TOP 
BOTTOM 


you will see the cursor placed on the Return character at the beginning of the line below the word HI. 


PROJECT SUGGESTIONS 
Write a brief poem on the screen. Have the cursor move to each word, in the rhythm that you would read the poem. 


Choose a different song than “Row, Row, Row Your Boat.” Put the lyrics on the page and have the cursor move to the 
appropriate words as the song is played. 
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33. Using Editing Commands From Procedures 


You have learned to use Select, Cut, Copy, and Paste to edit text in the word processor. There are LogoWriter commands 
which allow you to perform these same functions from procedures. Suppose you have the following text on the page. Now, 
explore how the commands SELECT, COPY, and PASTE work. Type 


You can change text using commands 
typed in the Command Center or from 
procedures. 

| 





Press Return/Enter here. 
Then type 


TOP 
SELECT 


Then enter 

REPEAT 3 [CF] 

The word “You” is then highlighted. Next type 
COPY 

The word “You” is no longer highlighted. Then type 


BOTTOM 
CB 


and the cursor moves to the end of the text. Finally, type 


PASTE 


and the paragraph looks like this: 


You can change text using commands 
typed in the Command Center or from 
procedures.You 
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You have not yet used CUT. Try typing 


TOP 

SELECT 
REPEAT 4 [CF] 
CUT 

BOTTOM 

PASTE 


and the paragraph looks like this: 


can change text using commands 
typed in the Command Center or from 
procedures.You 

You 





The word “You” was selected and then cut from the beginning of the sentence and pasted at the end of the paragraph at the 
position of the cursor. The text automatically adjusted on the page just as it does when you are using the word processor. 


There is also a command that corresponds to the Delete or Backspace key. Using the text that is already on the page, type 


REPEAT 5 [CB] 
REPEAT 6 [DELETE] 


and the paragraph looks like this: 


can change text using commands 
typed in the Command Center or from 
procedures. 

|| 





Note: The DELETE command deletes the character under the cursor. The backspace and Delete keys work somewhat 
differently on different kinds of computers. Take a moment to compare the way the command DELETE works as compared 
with your Delete/Backspace key. 


There is also acommand that corresponds to the TAB key. Try typing 


TOP 
TAB 
TAB 
INSERT [This is a mess] 


In Apple LogoWriter, the cursor moves to the top and moves forward to column 5 after the first TAB command and then moves 
to column 10 after the second TAB command. (In IBM and Macintosh LogoWriter TAB moves 8 spaces.) The text moves out 
of the way. The phrase “‘This is a mess” is then added to the paragraph: 
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This is a messcan change 
text using commands typed in the 
Command Center or from 
procedures. 





Here are a couple of examples using the commands that you have just learned. Suppose you want to write a procedure that 
would delete the first 5 characters from a sentence on the page. You might write 


TO DELETE.5 

TOP 

REPEAT 5 [DELETE] 
END 


or you could write 


TO DELETE.5 
TOP 

SELECT 
REPEAT 5 [CF] 
CUT 

END 


Suppose you wanted to put a title on a paragraph that is already on the page. You could write 


TO TITLE 

TOP 

PRINT [This is my title] 
PRINT [] 

END 


and a title appears. 


Perhaps you want to put a last line on a page: 


TO END.IT 

BOTTOM 

PRINT [] 

PRINT [This is really the end!] 
END 


Anything you can do with keys, you can do from a procedure. When you have learned a bit more about text processing 
commands and reporters, you will find that you can do some useful and interesting projects. For now, concentrate on 
understanding how each of the new commands works. 


PROJECT SUGGESTIONS 


Spend some time practicing using these new commands. Type a paragraph on the page and then manipulate it from the 
Command Center. When you are comfortable with the commands, try writing some procedures to move groups of letters from 
one place to another on the page. 
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34. More on Text Manipulation 


You have learned how to use commands from the Command Center or procedures to move around in and modify text on 
the page. All of the commands that you learned did the same thing as keys on the keyboard. There are other primitives for 
manipulating text, some of which don’t correspond to key strokes. These commands and reporters give you even more 
capabilities for working with text. 


Again, start with this text on the page, 


You can change text using commands 
typed in the Command Center or from 
procedures. 

a 





Press Return/Enter here. 
and then type 


TOP 
SEARCH "commands 


The word “commands” is highlighted. SEARCH is a command that allows you to locate any word you want in the text on 
the page. 


Next, try typing 
SHOW SELECTED 
Logo prints 
commands 
in the Command Center. You can type 
UNSELECT 
to remove the highlighting. Next, try typing 


TOP 

CD 

SELECT 

EOL 

SHOW SELECTED 


This time the entire line or paragraph is highlighted. Logo prints the highlighted part in the Command Center. SELECTED 
is a reporter that returns the most recent text that is searched for or selected. (Remember to use UNSELECT to get rid of the 
highlighting.) 
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Next, type 


TOP 
REPLACE “text “XY2 


The cursor moves to the word “text,” deletes it, and puts XYZ in its place. REPLACE is a command that allows you to replace a 
single word with any other word that you want. 


You can change XYZ using commands 
typed in the Command Center or from 
procedures. 

a 





For now, you can replace only one word at a time. In Chapter 40 you will learn how to replace more than one word at a 
time. Note that in Macintosh LogoWriter, you can also use the Search menu option to do searches and replaces. 


Now, type 
TOP 
SELECT 
REPEAT 7 [CF] 
COPY 


SHOW CLIPBOARD 
LogoWriter prints the selected characters. 
You can 


CLIPBOARD is a reporter that returns the most recent text that has been copied or cut. That means that when you cut a section 
of text out, you can get it back later by typing 


PRINT CLIPBOARD 


at the appropriate spot on the page. 


There is a difference between SELECTED and CLIPBOARD. Carefully examine the following sequence of commands. 
With the most recent text on the page, type 


TOP 

SELECT 

REPEAT 7 [CF] 
SHOW SELECTED 
UNSELECT 


You see 
You can 
in the Command Center. Logo printed the text that was just highlighted. 


Now type 
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TOP 

SELECT 

REPEAT 7 [CF] 
COPY 

SHOW CLIPBOARD 


You also see 
You can 


Now type 


TOP 

SELECT 

cD 

REPEAT 3 [CF] 
SHOW SELECTED 
UNSELECT 


As expected, the word “you” appears in the Command Center. Now, type 


SHOW CLIPBOARD 


You see 
You can 


This time, CLIPBOARD and SELECTED reported different things. SELECTED reports the currently selected text; 
CLIPBOARD reports the most recent text that was cut or copied. 


These new commands give you flexibility both in writing procedures and in working with text in the word processor mode. 
For example, suppose you typed a paragraph and discovered that you misspelled the word “could.” Perhaps you spelled it 
“culd.” You can go to the Command Center and type 


TOP 
REPLACE "culd “could 


Using the up arrow key and pressing Retum repeatedly allows you to replace all of the misspellings at once. You could even 
write a procedure to accomplish this task. 


TO FIX 
TOP 
FIX.ALL 
END 


TO FIX.ALL 

REPLACE “culd "could 
IF FOUND? [FIX.ALL] 
END 


FOUND? is a new reporter. It returns “true” if REPLACE (or SEARCH) finds its target, “false” otherwise. In fact, you can 
write a procedure to replace any word you want: 


TO FIX 
TOP 

FIND .WHAT 
END 
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TO FIND.WHAT 

TYPE [Replace what?] <-—This pair of statements gets rid of the [ ] that SHOW produces. 
SHOW " 

WITH.WHAT READWORDCC 

END 


TO WITH.WHAT :OLD.WORD <-— This procedure “holds” the word to be replaced. 

TYPE (With what?) 

SHOW " 

FIX.ALL :OLD.WORD READWORDCC <— Remember that you have to define READWORDCC. 
END 


TO FIX.ALL :OLD :NEW 

REPLACE :OLD :NEW 

IF FOUND? [FIX.ALL :OLD :NEW] 
END 


These new commands give you the ability to write all sorts of useful procedures to use with text on the page. These could 
include both procedures to help with word processing and procedures to modify the text on the page. 


Do you recall the program from an earlier chapter to move the cursor to the beginning of each line of “Row, Row, Row 
Your Boat”? With SEARCH, you can highlight each word as the appropriate notes are played. 


Suppose you have the line 


ROW, ROW, ROW, YOUR BOAT 
on the page. You can write the following procedure to play the music while highlighting the words: 


TO ROW. ROW 

TOP 

REPEAT 2 [SEARCH “ROW TONE 262 20] 
SEARCH "ROW 

TONE 262 15 

SEARCH "YOUR 

TONE 294 5 

SEARCH "BOAT 

TONE 330 20 

END 


When you are working with text, you sometimes need to know whether you are at the end of the text on the page. The 
reporter TEXTLEN returns the length of the text on the page in number of characters. Thus, if you type 


CT 
PRINT [HELLO] 
SHOW TEXTLEN 


Logo prints 
6 


This corresponds to the number of letters in the word “HELLO” plus the carriage return character. TEXTLEN always returns a 
number corresponding to the number of characters of the text on the page. 


Sometimes you may also need to know where the cursor is on the page. The reporter TEXTPOS returns the current location 
of the cursor. Thus if you type 


SHOW TEXTPOS 
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Logo prints the character number of the current cursor position. The number reported by TEXTPOS is counted from the 
beginning of the text on the page to the location of the cursor. (Since the cursor on the Macintosh is really an insertion point, 
TEXTPOS reports the position to the right of the cursor.) 


Not only can you find out the current location of the cursor but, you can also place the cursor wherever you wish. Thus if 
you type 


SETTEXTPOS 30 


the cursor moves to the 30th character from the beginning of the text on the page. 


Using TEXTLEN and SETTEXTPOS, you can have a “dancing cursor.” Since TEXTLEN gives you the number of 
characters of text, you can select a random number corresponding to a cursor position within the text on the page using 


1 + RANDOM TEXTLEN 
This line will report a number between 1 and the length of the text. Now, put this into a procedure using SETTEXTPOS: 


TO CURSOR.DANCE 
REPEAT 20 [SETTEXTPOS 1 + RANDOM TEXTLEN] 
END 


Try this procedure on some text of your choice. This procedure is a fun way to create an interesting effect. 


In IBM and Macintosh LogoWriter, there is a CURSORCHAR primitive. In the IBM version, it reports the character under 
the cursor. In the Macintosh version, it reports the character to the right of the cursor. 


There are two other primitives that make a “connection” between the turtle and text. If you type 


cT 
PRINT [HELLO] 
SHOW CURSORPOS 


you see 
[-137 76] 
This is the location of the cursor in turtle coordinates (see Chapter 36). If you now type 


SETPOS CURSORPOS 


you see 





The turtle moves on top of the cursor. This interaction makes the creation of a rebus, or a riddle made up of pictures or symbols, 
from a procedure quite simple. For example, you might type 
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CG 


cT 

PRINT [] 

PRINT [I LOVE YOU!] 
TOP 

SEARCH "LOVE 

Cur 


REPEAT 5 [INSERT CHAR 32] <—Recall that CHAR 32 represents a blank space. 
REPEAT 3 [CB] <—DMoves the cursor to the middle of the space. 

SETSH 14 

PU 

SETPOS CURSORPOS 

BOTTOM <—This gets the cursor out from under the turtle. 

PD 

STAMP 


You then see 





This interaction between graphics and text can lead to a lot of interesting projects. 


TIPS AND TECHNIQUES 


Although you can see the text being manipulated when you write procedures to manipulate text on the page, sometimes the 
action occurs so rapidly that it is difficult to tell what is happening. Try inserting a WAIT command after each action, such as a 
cursor move or a REPLACE. 


Text manipulation procedures are an excellent place to use the idea of inserting diagnostic statements. However, you will 
want to use SHOW, not PRINT since a PRINT statement will insert text on the page you are manipulating. Thus you might 
insert such statements as 


SHOW TEXTLEN 
SHOW TEXTPOS 
SHOW CURSORPOS 


to help you keep track of the action in your procedure. 


Writing procedures that repeat some action until you reach the end of the text on the page can be a bit tricky. For example, 
suppose that you write 


TO FIND.A 

SEARCH "A 

IF NOT (TEXTLEN=TEXTPOS) [FIND.A] 
END 


This procedure is supposed to search for the letter A until the end of the text is reached. In fact, this procedure will not work as 
intended. When the last letter “A” is found, the cursor simply stays on the “A” and blinks. The end of the text is never reached. 
This is simply because of the way the SEARCH command works. One way to fix this procedure is to write 
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TO FIND.A 


SEARCH "A 
IF FOUND? [FIND.A] 
END 


Now the procedure continues to search until no more “As” are found. In general, when the cursor stops before the end of a text 
being searched, it has to do with the condition after IF. If you have such bugs, try a different stopping condition. 


PROJECT SUGGESTIONS 


Do you have some “favorite” spelling errors? Write a procedure to check for at least one of your errors and correct it if it is 
found. 


When you are typing, do you forget to put two spaces after punctuation marks at the ends of sentences? Write a procedure 
to check for “‘. ” (period, space) and replace it with “. ” (period, space, space). 


Write a procedure to encode text on the page. You might replace spaces with a letter, put numbers between every other 
letter, or add letters after certain vowels. When you get your encode procedure to work correctly, write a decode procedure to 
put it back in readable form. 


Write a procedure that will find all of the occurrences of a word and replace it with a stamped shape. For example, you 
might find the word “cat” every time it appears and replace it with the cat shape. 


With the commands you now know, you can write a procedure to write a procedure. All you need are PRINT and FLIP. 
Can you extend this idea and write a program that accepts commands from the keyboard and puts them into a procedure on the 
flip side of the page? 


SSS SS 
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In much that is written about Logo, you see the primitive MAKE used. Program examples in books and magazines use 
MAKE frequently. If you know another programming language, you may have been wondering why this book hasn’t taught 
you how to assign values of variables. Indeed the MAKE statement in Logo is used for the same purpose as LET in BASIC and 
in the same way as the assignment operator (:=) in Pascal. MAKE is used to assign values to names. 


So, why has MAKE not been introduced earlier? The primary reason is that in Logo MAKE is frequently over used. It is 
often unnecessary and simply clutters both the code and the Logo system’s memory. Learning to pass values among procedures 
is a necessary skill to learn to avoid over using MAKE. Using MAKE sparingly will result in better programming style and will 
help you as you move into more advanced programming in Logo. 

There are places where using MAKE is all but necessary and where its use is appropriate. For example, it is not uncommon 
to want to increment (add to) or decrement (subtract from) a value at a number of points within a Logo program. While 
procedure inputs can sometimes be used to accomplish this task, there are other instances where the use of MAKE is more 


sensible. Sometimes you want to collect information that is to be used throughout a Logo program. This might be accomplished 
with DATA statement in BASIC or with sequential files in Pascal. Using MAKE is sometimes the solution in Logo. 


In this chapter, you will learn the relationship between names created by using MAKE and names created as procedure 
inputs. You will also learn how to work with names created using MAKE. 


You have used procedure inputs to associate a name with a value, for example, 


TO GREET :WHOM 
(PRINT [Hi,] :WHOM 
END 


If you type 

GREET "Mike 

Logo responds 

Hi, Mike 

Within the procedure, you use :’s (dots) to see the value of the name of a procedure input. 
What happens if you go to the Command Center and type 

SHOW :WHOM 

Logo says WHOM has no value. Why? When you typed 

GREET "Mike 

WHOM had the value “Mike” within the procedure. 


The explanation lies in the fact that procedure inputs are local to the procedure in which they are defined. That is, both the 
name of the procedure input (in this case, WHOM) and the value associated with the name (in this case, Mike) cease to exist 
when the procedure finishes running. 


Technical Note: Procedure inputs are actually defined as long as the procedure is active. So, if a procedure calls another 
procedure, the name is actually accessible in that subprocedure. This is called dynamic scoping. If you use dynamic scoping to 
access the name of a variable in a subprocedure, it destroys your ability to test procedures independently of other procedures. 
Thus it is best not to rely on it. 
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There are times, however, that it would be convenient to have a name retain its value throughout a program. One place it is 
convenient to have a value available throughout a program is when you want to use the name of the user several times in a 
program. To do this you can use a procedure like this: 


TO ASK.NAME 

PRINT [What is your name?] 
MAKE "USER READLIST 

END 


Notice the quotation mark (“‘) in front of USER. You use it to define a name. A Logo name is a word and you will remember 
that the quotation mark is used to quote a name. Then, anywhere in the program, you can use 


PRINT :USER 


and the value assigned to USER will be printed. We say that this name is global to indicate that it is understood everywhere in 
the program. 


Technical Note: In LogoWriter, global names retain their value from page to page. Thus, you can use MAKE as one way to 
transfer information from one page to another. 


The general form of the MAKE command is 
MAKE “some.name “some. value 

You can read this as follows: “MAKE some.name have the value of some.value.” So, for example, if you have 
MAKE "THE.NAMES [MARY SAM TOM SUE] 


you read “MAKE the name THE.NAMES have the value of the list MARY, SAM, TOM, and SUE. In this case, THE.NAMES 
is a Logo name and must be quoted to be used with MAKE since the first input to MAKE must be a Logo word. 


Since global names become a permanent part of the page, some commands are needed to examine and manipulate them. In 
order to see what names are present, you can type 


PRINTNAMES 

to display all of the names (and their values) on the page, or 
SHOWNAMES 

to display all the names (and their values) in the Command Center. 


If you wish to get rid of all the names on the page, you can type 
CLEARNAMES 
If you wish to get rid of a name, you can type 
CLEARNAME "USER 


or, if there are several that you want to remove, you can type 


CLEARNAME [USER OLD.NAME WHICH.SPOT] 


With these tools, you can identify and work with global names. 


At this point you may have decided that MAKE always creates global names. Unfortunately, things are not that simple. 
You have seen that procedure inputs create local names, for example in the procedure GREET. 
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TO GREET :WHOM 
(PRINT [Hi,] :WHOM 
END 


You also saw how MAKE could create a global name. 


TO ASK.NAME 

PRINT [What is your name?] 
MAKE "USER READLIST 

END 


Consider this example. 


TO CHANGE :NUMBER 

PRINT :NUMBER 

MAKE “NUMBER :NUMBER + 1 
PRINT :NUMBER 

END 


If you run this procedure by typing 
CHANGE 23 


you see 


23 
24 


on the page. Is NUMBER local to the procedure CHANGE? Try typing 
PRINT :NUMBER 

a 

PRINTNAMES 


You see that NUMBER is not a global name. It has no value outside of CHANGE. Using MAKE to change the value of a local 
name does not make it global. 


Here are some “rules of thumb” to help you better understand how names work. 
¢ When MAKE is used outside of a procedure, it always creates a global name. 
* When MAKE is used inside of a procedure to create a new name, that name is global. 
¢ When MAKE is used to change the value of a procedure input (local name) that name remains local. 
You should take some time to internalize these “rules” so that when you encounter MAKE, you can think about it correctly. 


Macintosh LogoWriter includes a LOCAL primitive. Using LOCAL, you can create a name that functions much like a 
procedure input. For example, 


TO ASK.NAME LOCAL "USER 
PRINT [What is your name?] 
MAKE “USER READLIST 

(PRINT [HI] :USER 

END 


In this case USER is understood only in the procedure ASK.NAME (and its subprocedures). 
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TIPS AND TECHNIQUES 


In spite of the discussion at the beginning of this chapter about not over using MAKE, there are places where it is entirely 
appropriate to make use of the ability to assign global values to names. Many people, as they move into more advanced Logo, 
find using a series of MAKE statements helpful in understanding complex Logo instructions. A simple example follows: 


MAKE "CHOICE RANDOM 31 
MAKE “SHAPE.NUMBER 1 + :CHOICE 
SETSH :SHAPE.NUMBER 


Before going any further, take a moment to examine the punctuation used with MAKE. You should read the second MAKE 
statement as follows: “Make the name SHAPE.NUMBER have the value of 1 plus the value associated with the name 
CHOICE.” Using MAKE is one place where most people have some difficulty with punctuation. Remember that " quotes a 
word and : means the value associated with a name. The first input to MAKE is a word and the second is any Logo object. 


Notice that the three statements given above can be collapsed as follows: 


MAKE "SHAPE.NUMBER 1 + RANDOM 31 
SETSH :SHAPE.NUMBER 


since the value of CHOICE is RANDOM 31. Or, you can just write 


SETSH 1 + RANDOM 31 
since the value of SHAPE.NUMBER is 1 + RANDOM 31. 


As this last command illustrates, neither the name SHAPE.NUMBER, nor the name CHOICE is really needed to 
accomplish the task, but using several global names may be helpful in developing understanding of the problem to be solved in 
writing a particular procedure. Feel free to use the MAKE statement in your work to help you learn a new idea, especially in the 
following chapters on list processing. However, when you complete a project, you should attempt to “collapse” your multiple 
MAKE statements as much as possible. Your final work should contain only necessary (or reasonable) uses of MAKE. As your 
understanding of Logo programming grows, you will find this task increasingly easy. 


PROJECT SUGGESTIONS 


Experiment with MAKE. Be sure that you see how it works. Have you tried all of the statements in this chapter? If not, do 
so. Write some short procedures using MAKE. Compare the results with using procedure inputs. 
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36. Cartesian Commands 


When you work with the turtle in the “normal” turtle graphics, you use “body centered” commands. That is, the turtle 
moves relative to its current position. If you say RIGHT 90, the turtle turns right from where it currently is positioned. 
Similarly, if you say FORWARD S0, the turtle moves forward from its current position without changing direction. 


Sometimes it is useful to be able to move the turtle to a particular position on the page from within a procedure, much as 
Turtle Move allows you to position the turtle on the page. It is also useful to be able to have the turtle face a particular direction. 
The commands that do this are based on graphing, similar to that which you may have done in math class. You can think of the 
page as a sheet of graph paper. For example, if you are using an Apple computer with LogoWriter, the “graph paper” looks like 
this: 


(139,0) 





Notice that the origin, the point (0, 0), is in the middle of the page, where turtle 0 is found when you start LogoWriter. 
To place the turtle at a particular position on the screen, you can type 
SETPOS [50 60] 


The turtle moves 50 steps to the right of the center of the page and 60 steps up. If the pen is down, the turtle leaves a trail. 
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SETPOS [50 60] 
SHOW POS 


{50 60] 
a 





You can find the location of the turtle by typing 
PRINT POS 
and the x- and y-coordinates of the turtle’s position are printed. 
You can use SETPOS to create a point graphing program. For example, you might type 


TO GRAPH.POINT 
SHOW [What point do you want to graph?] 


PU 

SETPOS READLISTCC 
PD 

FORWARD 1 


SHOW [Another?] 
IF READCHAR = "Y [GRAPH.POINT] 
END 


You can also specify the direction that the turtle faces. Type 
SETH 45 


and the turtle tums to face the upper right hand comer of the page: 
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aS eee 
SETH 45 
= 





Type 


SETH 270 


and the turtle faces the left edge of the page: 


Bae ee ee eee 
SETH 270 

SHOW HEADING 

270 

a 





You can also check the direction the turtle is heading by typing 


SHOW HEADING 


The current direction in which the turtle is facing appears in the Command Center. 
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Cartesian commands and reporters can be useful in a variety of types of programs. Suppose you are writing a game 
program and you want to know the location of the turtle. You can check the position of the turtle to see where it is on the page. 
You saw that POS reports both the x- and y- coordinates of the turtle position. The primitive XCOR reports the x-coordinate of 
the turtle, while YCOR reports the y-coordinate of the turtle. (Note: If you are using LogoWriter Version 1.0 or 1.1, then 
substitute FIRST POS for XCOR and LAST POS for YCOR.) 


So, for example, if you type 
SETPOS [-20 50] 
PRINT POS 


PRINT XCOR 
PRINT YCOR 


you see 


[-20 50] 
-20 

50 

a 


PRINT POS 
PRINT XCOR 
PRINT YCOR 
B 





Some newer versions of LogoWriter contain a DISTANCE reporter. DISTANCE takes a list of two numbers as input and 
returns the number of turtle steps from the current turtle location to the point represented by the list of numbers. 


TIPS AND TECHNIQUES 


Earlier in this book you saw that some of these Cartesian reporters could be helpful in your work with “standard” turtle 
graphics. For example, you could place the turtle with Turtle Move and then use 


SHOW POS 


to determine its location so that you could use SETPOS in a procedure to place the turtle. Often these Cartesian reporters can be 
very helpful in debugging programs. Putting statements such as 


SHOW POS 
SHOW HEADING 


in a procedure in which the turtle is moving gives you a running account of what is happening. This can be very helpful in an 
animation program. 
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In general, reporters that return some information about the turtle or the cursor are good tools to use when trying to 
determine exactly what your program is doing. Keep in minds that statements such as 


SHOW CURSORPOS 
SHOW TEXTPOS 
SHOW COLORUNDER 
SHOW COLOR 

SHOW BG 

SHOW CLIPBOARD 
SHOW SHAPE 


are valuable tools that let Logo help you debug your programs. 


PROJECT SUGGESTIONS 


Practice using these coordinate commands. Be sure that you understand how each works. Write some procedures using 
coordinate commands to draw shapes. 


Complete the graphing program started above. Add labels to the axes. Put “tic marks” on the axes and label them as well. 


Create a game program. Decide on a target. Test to see if the turtle has landed on the target. 
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37. Predicates 


The word “predicate” is a new term used to categorize procedures. It refers to a special kind of reporters. You have seen 
and used quite a few reporters. Different reporters report different kinds of Logo objects. For example, RANDOM reports 
numbers while CLIPBOARD reports words. The term “predicate” refers to reporters that return only ‘“‘true” or “false.” 

Why do you need such a class of reporters? Think about what goes after IF or IFELSE. You have always used something 
like =,< or >. Earlier you saw that these symbols are actually reporters. Since they return only “true” or “ false,” they belong 
to the special class of reporters called predicates. For example 
SHOW 3 = 4 
displays 
false 
while 
SHOW 3 < 4 
displays 
true 

Most of the new reporters which you will learn about in this chapter end in a (?). (In many versions of Logo, predicates 
end in “p,” for predicate.) There is nothing magic about the “?” at the end. It is just there to alert you that you that you are 
working with a predicate. Putting a “?” at the end of a procedure name does not tum that procedure into a predicate. Keep in 
mind that what makes a procedure a predicate is the fact that it reports only “true” or “false.” 

You have also seen FOUND? Recall that, FOUND? returns “true” if a word is located and “false” otherwise. If you type 
SEARCH "The 
and if “The” is in the text being searched, then you can type 
SHOW FOUND? 
and 
true 


appears in the Command Center. 


There are two reporters that are closely related to =. The reporter EQUAL? behaves the same way as the equal sign except 
that both inputs must follow EQUAL?. If you type 


SHOW "A = "a 

Logo displays “true.” If you type 

SHOW EQUAL? "A "a 

then Logo also displays “true.” The EQUAL? reporter does not distinguish between capital and lowercase letters. Try typing 


SHOW IDENTICAL? "A "a 
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Logo displays “false” in the Command Center. IDENTICAL? can be used to check for capitalization. 


There are three predicates that are used with IF and IFELSE to create compound conditions. These reporters are NOT, 
AND, and OR. 


NOT “reverses” the output from whatever follows it: 


SHOW 3 = 4 
false 

SHOW NOT 3 = 4 
true 


AND and OR are used when you want to examine more than one condition: 


SHOW 5 > 0 

true 

SHOW 5 < 10 

true 

SHOW AND (5 > 0) (5 < 10) 
true 

SHOW 5 > 0 

true 

SHOW 5 > 10 

false 

SHOW OR (5 > 0) (5 > 10) 
true 


It takes practice to use these three reporters. Once you master them, you can create more complex IF statements rather than 
numerous simple ones. (In Macintosh LogoWriter, you can also use the reporters <>, >=, and <=.) 


You might use AND to check that a number is in the proper input range. For example 


TO CHECK :NUMBER 

IFELSE AND (:NUMBER > 0) (:NUMBER < 100) 
{PRINT [You are in the correct range.]] 
{PRINT [Pick a number between 0 and 100.]] 

END 


OR can be useful if you want to write a game that controls the range of the turtle, for example, 
IF OR (XCOR > 139) (XCOR < -138) [RIGHT 180] 


This statement will “bounce” the turtle off the sides of the page in Apple LogoWriter. (Remember, in Versions 1.0 and 1.1, 
you must use FIRST POS instead of XCOR.) Here’s a more complex statement to keep the turtle on the page of an Apple 
screen. 


IF (OR ((XCOR) > 138) 
((XCOR) < -139) 
((YCOR) > 89) 
((YCOR) < -88)) {RIGHT 180] 


If the turtle reaches the edge of the page, then it tums completely around. 
There is yet another group of reporters. These are useful for checking input. 


NUMBER? retums “true” if its input is a number; otherwise, it returns “false.” 
WORD? retums “true” if its input is a word; otherwise, it returns “false.” 
LIST? retums “true” if its input is a list; otherwise, it returns “false.” 








190 37. Predicates 


For example, you might write a procedure like this: 
TO DRAW.PICTURE 
PRINT [Type a number:] 
CHECK.AND.DRAW READWORD 
END 
TO CHECK.AND.DRAW : INPUT 
IFELSE NUMBER? : INPUT 
[FORWARD : INPUT] 


[DRAW . PICTURE] 
END 


When you type DRAW.PICTURE, Logo prints 
Type a number: 
If you type a number, the turtle moves forward. If you type anything else, the procedure asks for a number again. 


Another useful predicate that returns true or false is MEMBER? MEMBER? checks to see if its first input is contained in its 
second input. If so, it returns true. Otherwise it reports false. For example, if you want to check to see if a character is a 
vowel, you can use MEMBER: 


TO CHECK :CHARACTER 

IFELSE MEMBER? :CHARACTER [A E I O U] 
[PRINT [A vowel] ] 
{PRINT [Not a vowel]}] 

END 


If you type 
CHECK "A 
Logo displays 

A vowel 

but if you type 
CHECK "“B 
Logo displays 
Not a vowel 


Suppose you wanted to turn some text on the page into Pig Latin. There are different versions of Pig Latin, but one set of 
rules says if a word begins with a vowel, then just add “ay” to the end; otherwise, move the first letter to the end of the word 
and add “ay.” 
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To tum the word into Pig Latin, you can use 


TO PIG.WORD 
SELECT 
CF 
IFELSE MEMBER? SELECTED [a e i 0 u] 
[UNSELECT 
SEARCH CHAR 32 
CB 
INSERT "ay] 
(CUT 
SEARCH CHAR 32 
CB 
INSERT CLIPBOARD 
INSERT "ay] 
CF 
END 


Now all you need to do is move through the text until the end of the text is encountered. 


In Macintosh LogoWriter, you learned about the TOUCHING? predicate (Chapter 27). Macintosh LogoWriter also 
includes the predicates LESS? and GREATER?, which can also be used to compare two numbers. 


TIPS AND TECHNIQUES 


Earlier in this book you saw that bugs could arise in IF statements if you didn’t use parentheses around conditions using =, 
> and <. You can avoid these problems by using EQUAL? instead of = . If your version of LogoWriter doesn’t have 
GREATER? and LESS? primitives, you can write them: 


TO GREATER :INPUT.1 :INPUT.2 
OUTPUT :INPUT.1 > :INPUT.2 
END 


TO LESS :INPUT.1 :INPUT.2 
OUTPUT :INPUT.1 < :INPUT.2 
END 


Using these predicates will avoid the problems created by the infix notation of standard mathematics. 


The predicates AND, OR, and NOT are very powerful, but can be confusing to use at first. Recall that one technique for 
testing conditions is to run them in the Command Center. So, for example, if you have the statement 


IFELSE AND (:NUMBER > 0) (:NUMBER < 100) 


and it doesn’t seem to be working correctly, you can test it by running it in the Command Center with specific numbers. For 
example, you might test 


AND (5 > 0) (5 < 100) 
AND (150 > 0) (150 < 100) 


Studying the results of such tests will help you understand AND, OR, and NOT better, as well as help you debug your 
programs. 


Writing your own predicates can be a way of simplifying your programs. Thus, if you have a statement such as 


IF (OR ((XCOR) > 138) 
((XCOR) < -139) 
((YCOR) > 89) 
((YCOR) < -88)) [RIGHT 180] 


you can move the complex part of this statement to a procedure 
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TO EDGE? 

OUTPUT (OR ((XCOR) > 138) ((XCOR) < -139) ((YCOR) > 89) ((YCOR) < -88)) 
END 

and the IF statement then becomes 

IF EDGE? {RIGHT 180] 


making your program much easier to read and debug. 


PROJECT SUGGESTIONS 


Practice creating compound conditions using AND, OR, and NOT. Simply use SHOW statements to check the results of 
these conditions. The more you practice using these reporters, the easier it will be when you need them in a program. Can you 
write a procedure to check for a range of numbers of your choice? Can you keep the turtle within a “track” on the page? Where 
would NOT be useful? 


Put DRAW.PICTURE into a drawing utility in which the user can input both distance and angle. Be sure to check that the 
user types a number for the angle. 


Finish the Pig Latin program so that it will work for any text on the page. 
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38. FIRST, BUTFIRST, LAST, and BUTLAST 


You have worked with text on the page, both by using the word processor and by writing procedures to manipulate text. 
Many of the commands you used to write procedures corresponded to key combinations. You have seen FIRST when you 
wrote a READWORD procedure. FIRST is one of the primitives in Logo that is used with what is traditionally called list 
processing. Unlike text processing in which you can manipulate text that you see on the page, list processing involves working 
with Logo objects that are associated with local or global names. All of the primitives that you will examine in this and the 
following three chapters are reporters. Even though they are often referred to as list processing primitives, they can be used to 
manipulate any kind of Logo object: numbers, words, or lists. 


The earliest versions of Logo did not contain a turtle at all. They had none of the elaborate features of modern versions of 
Logo like LogoWriter. List processing was at the center of any activities that were done with Logo. However, writing list 
processing programs is not always easy. It takes programming skill, understanding of reporters, and familiarity with recursion, 
including embedded recursion. These next several chapters merely introduce you to the primitives needed to do sophisticated 
list processing. If you are interested in pursuing these ideas, then you should move next to Brian Harvey’s book Computer 
Science Logo Style , Volume I mentioned in the Introduction. 


Begin by studying these simple examples: 


SHOW FIRST "LOGO 
L 


SHOW FIRST [THIS IS LOGO] 
THIS 


SHOW FIRST 54321 
5 


It should be clear that the reporter FIRST takes either a word or a list as input (a number is a special kind of word) and returns 
the first letter in the word or the first element in a list. You have diagrammed such reporters like this: 


THIS IS LOGO 


THIS 





To be sure that you understand FIRST, what do you think Logo displays if you type 


SHOW FIRST [[LIST ONE] [TWO] [AND THREE}] 
Did you correctly deduce that Logo displays the first element of the list, which is the list [LIST ONE]? 


There is also a reporter LAST. What do you think it does? What inputs does it need? What output does it produce? Can 
you state your thoughts clearly and precisely? Take a few moments to experiment with LAST. 
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There are two “companions” to FIRST and LAST. Study these examples. 


SHOW BUTFIRST "LOGO 
OGO 


SHOW BUTFIRST [THIS IS LOGO] 
IS LOGO 


SHOW BUTFIRST 54321 
4321 


If BUTFIRST (short form BF) gets a word as input, it returns everything but the first letter of the word; similarly if it gets a list 
as input, it returns everything but the first element of the list. 


As you might guess, there is also a BUTLAST reporter. BL is the short form. Can you describe precisely how it works? 
Can you predict what examples similar to the ones above will produce? Can you diagram the way it works? Experiment with 
BUTLAST. 


These two pairs of reporters can be used to take lists apart by building a loop, much as you used the idea of incrementing 
to change numerical values earlier in this book. Consider this procedure: 


TO TAKE.APART :LIST.IN 

PRINT FIRST :LIST.IN 
TAKE.APART BUTFIRST :LIST.IN 
END 


If you type 


TAKE.APART [THIS IS LOGO] 
Logo prints 


THIS 
IS 
LOGO 


on the page and displays 


FIRST DOESN’T LIKE [] AS INPUT IN 
PRINT FIRST :LIST.IN 


in the Command Center. FIRST will not accept an empty word or list as input. To avoid this problem and stop a procedure 
such as this, you can modify the last line as follows: 


TO TAKE.APART :LIST.IN 

PRINT FIRST :LIST.IN 

IF NOT EMPTY? BUTFIRST :LIST.IN [TAKE.APART BUTFIRST :LIST.IN] 
END 


Recall that EMPTY? is a predicate that returns “true” if the word or list following it has nothing in it; otherwise, it returns 
“false.” Do you see why you must have the BUTFIRST in the last line rather than just :LIST.IN? Examine the diagram at the 
bottom of the page to see what is happening. It shows the changing values of the procedure input instead of the name of the 
procedure input. 
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TO TAKE.APART [THIS IS LOGO] 

PRINT [THIS] 

IF NOT EMPTY? [IS LOGO] [TAKE.APART [IS LOGO]]} 
END 


TO TAKE.APART [IS LOGO] 
PRINT [IS] 


IF NOT EMPTY? [LOGO] [TAKE.APART [LOGO]] 
END 


TO TAKE.APART [LOGO] 

PRINT [LOGO] 

IF NOT EMPTY? [] <—and the procedure stops 
END 





Take some time to be sure you understand what occurs in this procedure. 


You will often seen a procedure like this written as follows: 


TO TAKE.APART :LIST.IN 

IF EMPTY? :LIST.IN [STOP] 
PRINT FIRST :LIST.IN 
TAKE.APART BUTFIRST :LIST.IN 
END 


This version is a little easier to understand. It is not complicated by passing BUTFIRST :LIST.IN to the TAKE.APART. 
However, you need to be careful when you use this form that you don’t overuse STOP. It is easy to find yourself with a 
procedure such as this with several STOPs in it and even some unwanted embedded recursion. 


Although list-processing primitives usually work with the values of names, like the TAKE.APART procedure above, you 
can use the text processing primitives you used earlier to transfer text on the page to a name within a procedure. Suppose you 
have 


This is an example showing how to use 
text from the page. 
a 





EEE 
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You can write 


TO GET.TEXT 

TOP 

SELECT 

BOTTOM 

MAKE "TEXT PARSE SELECTED 
PRINT [] 

TAKE.APART : TEXT 

END 


SELECTED reports everything up to the end of the page, in this case up to the period at the end of the sentence. SELECTED 
returns a “word” made up of all of the characters selected; PARSE is a reporter that turns that word into a list. Then 
TAKE.APART puts one word of the text on each line. 


Note that the MAKE is not necessary in this procedure. It could be written as 


TO GET.TEXT 

TOP 

SELECT 

BOTTOM 

TAKE.APART PARSE SELECTED 
END 


When either of these procedures is run, you see 


This is an example showing how to use 
text from the page. 

This 

is 


an 
example 
showing 





TIPS AND TECHNIQUES 


Thoroughly understanding the simple ideas presented in this chapter is the first step to moving into more advanced Logo 
programming. Beware, however, of the simplicity of the ideas. There can be subtle differences that are easy to miss. For 
example, did you notice that SELECTED returns a word? That means that if you type 


SHOW SELECTED 


you might see the word 
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This is an example 
rather than the list 
(This is an example] 


All of the characters, including the spaces, make up one word. As you begin your work with list processing, it becomes very 
important to pay close attention to the distinction between Logo words and Logo lists. 


PROJECT SUGGESTIONS 


As suggested above, spend some time experimenting with each of these new reporters. Be sure that you understand how 
each functions. Pay particular attention to the difference between words and lists. 


Diagram the TAKE.APART procedure using a word as input instead of a list. 


Modify the TAKE.APART procedure so that it lists the words in reverse order. Can you write a program using 
GET.TEXT that takes a sentence off the page and then displays it as a sentence in reverse order on the page? 
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39. ITEM and COUNT 


You have seen the reporter TEXTLEN that returns the length in number of characters of the text on the page. There is a 
similar list processing reporter that works on any word or list, not just the text on the page. Study these examples. 


SHOW COUNT "LOGO 
4 


SHOW COUNT [THIS IS LOGO] 
3 


THIS IS LOGO 





SHOW COUNT [A [B C] [D) [E F G]] 
4 


In the last example above, there are four elements in the list, the word A, and the lists [B C], [D] and [E F G]. Each counts 
as one Logo object in the list. COUNT takes a word or list as input and returns the number of letters in the word or the number 
of elements in the list. 


Yet another reporter allows you to examine a particular letter in a word or object in a list. Consider these examples. 
SHOW ITEM 3 “LOGO 
G 
SHOW ITEM 2 [THIS IS LOGO] 
IS 


SHOW ITEM 3 [A [BC] [D] [E F G]] 
[D] 


ITEM takes two inputs: a number and either a word or a list. It returns the letter in the word or the element in the list in the 


place indicated by the number: 


THIS IS LOGO 


J’ 
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These new primitives can be put together to select a random element from a list. First, consider this statement: 


PRINT RANDOM COUNT [THIS IS LOGO] 
The possible numbers printed are 0, 1, and 2. Do you see why? (RANDOM reports numbers from 0 to 1 less than its input.) 


To pick randomly from a list, you can’t use 0; ITEM needs a number between 1 and the number of objects in its input. This 
can be accomplished by using 


PRINT 1 + RANDOM COUNT [THIS IS LOGO] 
This gives the numbers 1, 2, or 3. 


Next, the problem is to pick the element represented by this number. ITEM helps accomplish this task: 


PRINT ITEM (1 + RANDOM COUNT [THIS IS LOGO]) [THIS IS LOGO] 


Examine the statement above carefully. Study the diagram below. Look at one “box” at a time to see what is happening: 


THIS IS LOGO 


| COUNT | 
3 
RANDOM | 


2 <—— RANDOM3 gives 


° / \ 0, 1, or 2. 


+ 


{THIS IS LOGO] 
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Learning to think through complex instructions like this is one of the keys in learning to use list-processing reporters in Logo. 


As it stands, the above example is not particularly useful. However, the idea can be put into a procedure that accepts an 
input: 


TO PICK :IN 
PRINT ITEM (1 + RANDOM COUNT :IN) :IN 


END 
If you type 
PICK "LOGO 


then one of the letters in LOGO is printed, and if you type 


PICK [THIS IS LOGO] 
then one of the three words in the list is printed, as shown in the above diagram. 


However, to make PICK a tool that is useful in other procedures, the PRINT needs to be changed to OUTPUT: 


TO PICK :IN 
OUTPUT ITEM (1 + RANDOM COUNT :IN) :IN 
END 


Now typing 
PRINT PICK [THIS IS LOGO] 
causes one of the three elements in the list to be printed on the page. 


PICK can be used as a tool to generate a random sentence. Suppose that you type on the page 


Dog Tree Car Door House 
ran sat sang jumped ate fell Press Return/Enter at 
5 the end of each line. 
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You can then use the text-processing primitives that you learned earlier to get these words from the page: 


TO GET.WORDS 

TOP 

SELECT 

EOL 

MAKE "NOUNS PARSE SELECTED 
UNSELECT 

CD 

SOL 

SELECT 

EOL 

MAKE "VERBS PARSE SELECTED 
UNSELECT 

PRINT [] 

(PRINT PICK :NOUNS PICK :VERBS) 
END 


Logo now writes a random sentence using the words from the page. Using the above words, Logo might produce 
Dog ran 

or 

House jumped 

or 

Tree fell 

and so forth. 


Notice that MAKE was used in the above example. Here the two namcs NOUNS and VERBS were lists of “data” that 
might be used throughout a more complex program. This is an example where using MAKE seems appropriate. 


TIPS AND TECHNIQUES 


This PICK procedure is such a useful tool that many feel that it should be a primitive in Logo. In fact, the name PICK is 
used for this procedure in much that is written about Logo. With PICK you get the first real hint of Logo’s extensibility. If a 
version of Logo doesn’t have a particular primitive (XCOR, GREATER? PICK, etc.) you can just write it and add it to your 
page when needed. If you explore Logo programming in more depth, you will find yourself writing procedures that behave 
much like primitives. These procedures become your own personal “tool kit.” 


PROJECT SUGGESTIONS 


Experiment with ITEM and COUNT. Can you find ways to use them in programs that you want to write? Be sure that you 
understand how these new reporters work. 


Expand on the sentence generator described above. Can you add articles, adjectives, and adverbs? Can you write a 
procedure to have the user add words to the page before the program started to make sentences? How about saving the words 
on a separate page? 


Draw a diagram using inputs different from THIS IS LOGO for PRINT ITEM (1 + RANDOM COUNT :IN) :IN? 
Write a program using PICK to deal a hand of cards. Use a very small, incomplete deck of cards to create your program. 
Can you write a MY.FIRST procedure that acts like FIRST, but doesn’t use FIRST? How about a MY.BUTFIRST? 


Here’s a challenge: Write a MY.ITEM procedure that behaves just like ITEM, but doesn’t use ITEM. Can you write a 
MY . COUNT? 
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40. WORD, SENTENCE, and LIST 


So far you have used the list processing primitives to take lists and words apart, or to find one part of a list or word. There 
are times that you might also want to put words and/or lists together. This next group of reporters is used to accomplish this 
task. 


Suppose that you want to add an S to a word to make it plural. You might try typing 
(SHOW "DOG "S) 
but Logo displays 
DOG S 
You can solve the problem with the reporter WORD. Typing 
SHOW WORD "DOG "S 
causes the word 
DOGS 
to be displayed. WORD takes two words as input and returns a single word. 
WORD can be used with SEARCH and REPLACE to find mosre than one word at a time. For example, SEARCH (WORD 
“IS CHAR 32” AN) will find “‘is an” in the text on the page. Note that parentheses are used here, since WORD has three inputs, 
and that CHAR 32 is used to represent the space between the words. 
In Macintosh LogoWriter, the vertical bar (|) can be used to search for several words: 


SEARCH "|CATS AND DOGS | 


The related reporter SENTENCE (short form SE) accepts two words or lists as inputs and returns a single list. Thus if you 
type 


SHOW SENTENCE [THESE ARE] [TWO PARTS] 
Logo displays 
[THESE ARE TWO PARTS] 


Recall that SHOW displays the brackets when you have it print a list. This property of SHOW can be very helpful when 
working with the list-processing capabilities of Logo, especially when you are debugging programs. If you type 


PRINT SENTENCE [THESE ARE] [TWO PARTS] 
then you see 


THESE ARE TWO PARTS 


PRINT removes the outer pair of brackets. 
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In older Logo books, you will often see statements like this: 
PRINT SENTENCE [HI,] :NAME 
instead of 
(PRINT [HI,] :NAME) 


Many early versions of Logo did not let you use parentheses to allow PRINT to have more than one input, so you had to use 
SENTENCE to create a single input for PRINT. 


LIST is another reporter that accepts two words or lists as input and returms a list. For example, if you type 
SHOW LIST [THESE ARE] [TWO PARTS] 

Logo displays 
({THESE ARE) [TWO PARTS}] 


Compare SENTENCE and LIST. Notice the difference in output with the same input. You may find the difference a bit 
confusing. The secret lies the fact that SENTENCE “flattens” a list; i.e., removes extra brackets. 


Now, compare SENTENCE and LIST in the diagram below: 


(THESE ARE] [TWO PARTS] [THESE ARE] [TWO PARTS] 


SENTENCE 


{THESE ARE TWO PARTS] [({THESE ARE] [TWO PARTS]] 


THESE ARE TWO PARTS [THESE ARE] [TWO PARTS] 


This text appears on the page. 





This technical distinction sometimes becomes important in more advanced work with lists. 
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One way you might use SENTENCE is to create a list from words typed at the keyboard: 


TO GET.WORDS :THE.LIST 
PRINT [Type a word.. Type S to stop.] 
MAKE "THE.LIST SENTENCE :THE.LIST READWORD 
IFELSE EQUAL? LAST :THE.LIST "S 

(USE.LIST :THE.LIST} 

[GET.WORDS :THE.LIST] 
END 


The USE.LIST procedure, which is not shown here, would be a procedure that made some use of the list just generated. 


The diagram at the below follows the procedure GET.WORDS through several steps, using the values for the name 
THE.LIST. As you look at the diagram, do you see the bug in this program? Look carefully at the last call to USE.LIST. Do 
you see that the S is being passed to USE.LIST as one of the words in the list? Can you fix the bug? 


TO GET.WORDS [] 
PRINT [Type a word. Type S to stop.] 
MAKE "THE.LIST SENTENCE [] READWORD <———— Cat is typed 
IFELSE EQUAL? LAST [Cat] "S 
(USE.LIST [Cat] STOP ]«———— This line is not run. 
(GET.WORDS [Cat]] 
END 


TO GET.WORDS [Cat] 
PRINT [Type a word. Type S to stop.] 
MAKE “THE.LIST SENTENCE [Cat] READWORD <———— Dog is typed 


IFELSE EQUAL? LAST [Cat Dog] "S 
(USE.LIST [Cat Dog] STOP] <—— This line is not run. 
[GET.WORDS [Cat Dog]] 

END 


TO GET.WORDS [Cat Dog] 
PRINT [Type a word. Type S to stop.] 
MAKE "THE.LIST SENTENCE [] READWORD <«——— Cat is typed 
IFELSE EQUAL? LAST [Cat Dog S]} "S 

{USE.LIST [Cat Dog S] STOP] 

[GET.WORDS [Cat Dog S]]<—— Now this line is not run. 
END 





TIPS AND TECHNIQUES 


In this chapter you again see the importance of understanding the distinction between a Logo word and a Logo list. When 
you have trouble with SENTENCE and LIST, make use of SHOW to display the results. In more advanced programming, the 
distinction between using SENTENCE and LIST can be very important. ~ 


In Macintosh LogoWriter, WORD can also take lists as input. Thus, WORD [HIJ[THERE] reports the word HITHERE. 


PROJECT SUGGESTIONS 


Take the diagram of GET.WORDS and go one step further. That is, show the value of LAST :THE.LIST instead of just 
:THE.LIST. 


Fix the bug in GET.WORDS. Then write a USE.LIST procedure. Perhaps you could have USE.LIST list the words on a 
single line on the page. 

Take some time to explore the differences among WORD, SENTENCE, and LIST. Use SHOW with both simple and 
compound lists. See if you can predict the outcome of each statement before you press Return/Enter. 


Use the ideas for creating random sentences and the ideas from this chapter for making lists of words and write a program 
that will accept lists of words from the keyboard and print random sentences on the page. 
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41. FPUT and LPUT 


Sometimes you want to add things to an existing list rather than just putting lists together. The primitives to accomplish this 
task are LPUT and FPUT. Here are a couple of examples: 


SHOW FPUT “SOMETHING [LOTS OF THINGS] 
[SOMETHING LOTS OF THINGS] 


SHOW LPUT "JUNK [MESS FUSS] 
(MESS FUSS JUNK] 


FPUT accepts an object and a list as input and reports a list made up of the object and the list. LPUT accepts an object and a list 
as input and reports a list made up of the list with the first object on the end. 


An example in the last chapter showed a way to create a list of words. Here is another approach: 


TO ADD.NOUNS :LIST.IN 
PRINT [] 

INSERT [(NEXT) NOUN -->] 
ADD.MORE READWORD :LIST.IN 
END 


TO ADD.MORE :WORD.IN :THE.LIST 
IF NOT (:WORD.IN = "QUIT) 

{ADD.NOUNS FPUT :WORD.IN :THE.LIST] 
END 


The second procedure is needed to “hold on” to the value typed so that it can be checked. The two procedures work together to 
produce a list that can be used. Below is an example of running this procedure: 


ADD.NOUNS [] 


( NEXT ) NOUN -->CAT 
( NEXT ) NOUN -->DOG 
( NEXT ) NOUN -->RAT 
( NEXT ) NOUN ~->QUIT 


Notice that the list THE.LIST in procedure ADD.MORE is a local name. That is, it only exists when ADD.MORE is 
running. If you need to use the list elsewhere, then you must pass it to another procedure. For example, you might modify 
ADD.MORE as follows: 


TO ADD.MORE :WORD.IN :THE.LIST 
IFELSE (:WORD.IN = "QUIT) 

[USE.LIST :THE.LIST] 

{[ADD.NOUNS FPUT :WORD.IN :THE.LIST] 
END 


Procedure USE.LIST then makes use of the list created. 


FPUT or LPUT can also be used to put together several paragraphs from the page into one list, for example, 


TO GET.TEXT 

TOP 

SELECT 

EOL 

GET.MORE (LIST PARSE SELECTED) 

END 

TO GET.MORE :ALL 

CE 

UNSELECT 

SELECT 

EOL 

IFELSE TEXTLEN = TEXTPOS 
(PRINT :ALL] 
[GET.MORE LPUT PARSE SELECTED :ALL] 

END 


The procedure GET.TEXT selects the first paragraph and passes a list made up of the text in the first paragraph into ALL in 
GET.MORE. Then each subsequent paragraph is selected and added to the end of the list. 


As with the other list-processing primitives, you should spend some time working with FPUT and LPUT. Be sure you 
understand how they work. SHOW is a good vehicle for being sure whether you are working with words or lists. 


TIPS AND TECHNIQUES 


You have now seen the list-processing primitives that are necessary for advanced programming in Logo. Have you noticed 
that they fall into several categories? 


FIRST, LAST, BUTFIRST, BUTLAST: used to take Logo objects apart 
ITEM, COUNT: used to examine Logo objects 

WORD, SENTENCE, LIST: used to put together Logo objects 

FPUT, LPUT: used to add Logo objects to a list 


Keeping these categories in mind is helpful as you think about wniting a program that manipulates Logo objects. 


PROJECT SUGGESTIONS 


Draw a diagram showing what happens when ADD.NOUNS is run with the words shown in the sample run in the text. 
Draw a diagram showing what is happening when you run GET.TEXT. 
The primitive FLIP causcs the page to be flipped. The reporter FRONT? tells you whether or not you are on the front of the 


page. Can you write a program that will write a procedure on the flip side of the page? Can you allow the user to enter lines of 
code that then get put into a procedure? 
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Appendix 1: Setting Up Your LogoWriter Disks 


GETTING STARTED USING LOGOWRITER 1.0 OR 1.1 


If you are using Apple LogoWriter Version 1.0 or 1.1, then the disk you received has two sides. One side contains the 
LogoWriter language; the other is a Disk Manager (which may be labelled Master Disk) that will allow you to create Scrapbook 
(file) disks and configure your LogoWriter disk for the appropriate printer. 


First, start the LogoWriter Disk Manager. After the initial LogoWriter screen appears, you should see 


LOGOWRITER 
version 1.1 
DISK MANAGER 


1) Create a Scrapbook disk 
2) Specify a printer 


Type the number you want: 
Press @-0 for Help 





Select 1. 


You will then see 
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LOGOWRITER 
version 1.1 
DISK MANAGER 


Create a Scrapbook disk 


Source in Slot: (6) 
in Drive: (1) 


Destination in Slot: (6) 
in Drive: (1) 


Press RETURN to accept, ESC to exit 
Press ¢€-0 for Help 





You must press Return to accept the slot and drive number; the Arrow keys don't work. If you make a mistake, press Esc 
and try again. If your disk drive is not connected to slot 6, change the slot number. If you have only one disk drive, change the 
drive number from <2> to <1>. Press Return and follow the directions at the bottom of the screen. When the message WORK 
COMPLETED appears, remove your new Scrapbook disk. Repeat the process until you have the number of Scrapbook disks 
you feel you will need. 


Next, you need to configure your LogoWriter disk for the appropriate printer. Begin by returning to the main menu (the 
first screen shown above) and pressing 2. A list of printers will appear. Use the Arrow keys to select the appropriate printer and 
press Return to accept that printer. Next, a list of interface cards appears. Again use the Arrow keys to select the appropriate 
card and press Return. Now this menu appears: 


LOGOWRITER 
version 1.1 
DISK MANAGER 


Specify a printer 


Destination in Slot: (6) 
in Drive: (1) 


Press RETURN to accept, ESC to exit 
Press €-0 for Help 
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Select the correct slot and drive, put in your LogoWriter disk (not a Scrapbook disk and not the Disk Manager) and press 
Return. When WORK COMPLETED appears, you are finished. 


GETTING STARTED USING LOGOWRITER 2.0 


If you are using a recent version of LogoWriter, then you do not need to use a different disk to configure your LogoWriter 
Master Disk for a printer. You can find out the version number by typing 


SHOW .VERSION 


Don’t forget the period before the word “‘version.” If you have an Apple version with a number lower than 2.03, call LCSI 
(1-800-321-5646) for a free upgrade. 


To get started with the Apple IIe/IIc version, put your LogoWriter language disk in the disk drive and start your computer. 
Immediately hold down the “Open Apple” key. After a good bit of whirring by the disk drive, a screen appears that allows you 
to choose a printer. If you are using an Apple computer, you see something like: 


Printer Select 
Use up and down arrows to choose a 
printer and press Return. 


Color ImageWriter II 

Apple Imagewriter 

C Itoh 

Epson 

Epson printer with APL card 
Okidata M192 





Use the Arrow keys to select the printer you are using. Then press Return/Enter. 


Appendix 1: Setting Up Your LogoWriter Disks 213 


Next, a menu that allows you to select an interface card appears. Again, if you are using an Apple IIe or IIc computer, you 
see a list like this: 


Use up and down arrows to choose a 
printer and press Return. 


Super Serial Card (1) 

Super SErial Card (7) 

Apple II Workstation Card 
Apple Parallel Interface Card 
Apricorn PrinterPro card 
Apricorn serial card 

Epson APL card 

Fingerprint+ (parallel) 
Fingerprint+ (serial) 





In some cases this list is quite long. You can scroll down the list by using the Arrow keys. When you find the interface card 
for your computer, press Return/Enter. After some more whirring by the disk drive, you will see the usual LogoWriter 
introductory screen. The disk in your disk drive is now configured for the printer and card that you selected. 


If you are using the Apple GS version of LogoWriter, start LogoWriter and select the page SETUP.PRINTER. Type the 
word associated with your printer to configure your disk. If you are using the built-in printer port or your printer card is in slot 
1, press Esc to return to the Contents Page. If you have a printer card in a different slot, type SETPRINTERSLOT slotnumber 
to change the slot number used. 


If you are using IBM LogoWriter Version 2.0, then there are a number of batch files that you run from DOS to set up your 
printer. You’ ll need to see your documentation to know which file to use for your particular combination of interface card and 
printer. 


If you are using Macintosh LogoWriter, then you can print on an ImageWriter or an Apple Laser printer. Your system 
folder must contain the correct documents and the printer must be selected in the Chooser. See your Macintosh documentation. 


CHECKING YOUR PRINTER 


Finally, you need to check your newly configured disk to see if it prints correctly. When you have the LogoWriter 
introductory page on the screen, press Retum, and select NEW PAGE from the Contents Page. 


Now type 


REPEAT 4 [FORWARD 50 RIGHT 90] 


A square should appear on your screen. Next press the Up keys. Then type several lines of text without pressing Return. 
For example, you might type 


This is a test to see if my printer is 
working correctly. If your printer 

configuration is not working correctly, 
you can call for technical assistance. 
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Now, press the Down keys. Type PRINTSCREEN. A picture should appear that includes the text you typed (in large 
letters) and the square. Next type PRINTTEXT. The text should appear exactly as it is on the screen. Finally; type 
PRINTTEXTS80 (Apple and IBM versions). The text should now appear double spaced, but 60 characters wide. 


Note: If you are using Macintosh LogoWriter, then you must have the correct documents in your system folder in order for 
printing to work correctly. 


If any of the above tests does not work correctly, check your configuration again. If anything is wrong, call LogoWriter 
technical support at 514-331-2791. 





Appendix 2: STARTUP 


STARTUP is a word that has special meaning in LogoWriter. There are two uses for the word STARTUP: to name 
procedures and to name pages. 


If you name a procedure STARTUP, then that procedure will automatically run when you load the page with procedure 
STARTUP on the flip side. 


If you name a page STARTUP, then that page is automatically loaded when you start LogoWriter. 


Thus, if you want a page to automatically load and run, then you name the page STARTUP. On the flip side of this page, 
you must have your top-level procedure called from a procedure named STARTUP. 


NOTE: There can be only one STARTUP page on a scrapbook disk and only one STARTUP procedure on the flip side of 
any page. 
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Appendix 3: Chaining Pages 


If you have written programs that are very long, you may have discovered that you can use up the space that is available in 
LogoWriter. However, the space available on one page is really not a limitation. You can put LogoWriter pages together to get 
more space, just as you can add paper pages to a scrapbook. 


Begin by creating two pages: 
DESIGN should contain some graphics design. 
TEXT should contain some writing on the page. 
Now create a third page called BOTH. Flip the page and enter the following procedure: 


TO CHOOSE 
GETPAGE "DESIGN 
WAIT 20 

GETPAGE "TEXT 
END 


Type 
CHOOSE 


and you first see your design and then your text. When the procedure is done, you are on the page TEXT. You must include a 
command to get the page BOTH in order to end up on BOTH when the procedure finishes running. You can make this 
procedure interactive by adding a few lines: 


TO CHOOSE 

GETPAGE "DESIGN 

WAIT 20 

GETPAGE "TEXT 

WAIT 20 

GP "BOTH 

INSERT {Would you like to see these pages again?] 
IF READLIST = [Y] [CHOOSE] 

END 


Notice that READLIST is checked against the list containing only the letter Y. If the user types YES, the procedure stops. It 
is usually a good idea to tell the user what to type, for example, 


INSERT [Would you like to see these pages again? (Y or N)] 


LogoWriter has a special word, STARTUP (see Appendix 2), that can make working with multiple pages even more 
interesting. Change your DESIGN page so that it contains these procedures: 


TO STARTUP 
MAKE .DESIGN 
ASK.Q 

END 


TO MAKE .DESIGN 

CG 

any design you want here 
END 
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TO ASK.Q 

SHOW [Do you want to see the design again?] 
IF READLISTCC = [Y] [STARTUP] 

END 


Notice that ASK.Q calls STARTUP recursively. This recursion is delayed, but it is recursion nonetheless. Save this page. 


Now modify your page TEXT so that it contains 


TO STARTUP 
MESSAGE 
ASK.Q 

END 


TO MESSAGE 

CT 

any text you want goes here 
END 


TO ASK.Q 

SHOW [Do you want to see the message again?) 
IF READLISTCC = [Y] [STARTUP] 

END 


Save this page. Now, go to your page BOTH and type 
CHOOSE 


Logo gets the page DESIGN, and the STARTUP procedure is automatically run. Anytime you put a STARTUP procedure on a 
page, that procedure runs automatically every time you load the page. So, when DESIGN is loaded from BOTH, the design is 
repeated as often as you want. Then Logo gets the page TEXT and its STARTUP procedure is automatically run. The message 
is repeated as often as you want. Then Logo retums to the page BOTH and asks if you want to repeat the entire program again. 


When you set up both a STARTUP page and STARTUP procedures, you may find it hard to stop the procedures from 
running when you want to change them. To get any STARTUP procedure to stop, hold down the Stop keys as soon as the page 
Starts to load. Don’t just press them and then release them. Hold them down until the message “‘sto) !” appears at the bottom 
of the screen. 
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Appendix 4: Using Tools 


There are a number of commands that allow you to work with “tool” pages in LogoWriter. A tool page is really no different 
from any other LogoWriter page. However, when you use a page as a tool page, the procedures from that page are loaded into 
the memory of the computer. They are not visible on the flip side of the page. Thus, they use up less space. To use a page as a 


tool page, you type 
GETTOOLS “page.name 
The procedures on the page loaded then become available on the current page. To see what tools are available, you can type 


PRINT TOOLLIST 


TOOLLIST is a reporter that returns the list of available tool procedures. Although you can’t see the procedures, you can at least 
see the names. If you no longer want tools, you can type 


CLEARTOOLS 


When you are using tool pages, it is easy to forget how many procedures you have added to your page using GETTOOLS. 
If you are working with tools and get an “out of space” error, try using CLEARTOOLS to reclaim some memory space. 





Appendix 4: Using Tools 221 





Appendix 5: The WHEN Command 


The WHEN command in LogoWriter allows you to “program” keys to perform a specific task. This command is useful 
when using the word-processing mode of LogoWriter or when writing games, but any LogoWriter commands can be used with 
WHEN. 


What are the things you commonly put in a letter? Usually there is a date, a greeting, and a closing. On the back of the page, 
type 
TO DATE 


WHEN "X [PRINT [January 5, 1987]] 
END 


Be careful to put the quotation mark ("}—-with no space—before the X. Now flip the page and type 
DATE 


Nothing happens. Next, press Control-X. (In the Macintosh version, hold down Option-Shift-X.) Be sure to hold down 
the Control key and then press the X key. What happens? Press Control-X again. Do you see that Control-X now stands for the 
date? Add the following procedures to the flip side of the page: 


TO LETTER.HELPERS 

DATE 

GREETING 

CLOSING 

END 

TO GREETING 

WHEN "Y [PRINT [] PRINT [Dear]] 
END 

TO CLOSING 


WHEN "Z [PRINT [Sincerely,] REPEAT 4 [PRINT []] PRINT [T. H. E. Turtle]] 
END 


Now type 
LETTER.HELPERS 


and then press Control-X, then Control-Y, write a short letter, and finally press Control-Z. (If you are using Macintosh 
LogoWriter use Option-Shift instead of Control.) Now all you have to do is type 


PRINTEXT 
or 


PRINTTEXT80 


and your letter is done! 
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There are 10 keys that can be programmed using WHEN. They are 
NOPQRVWXYanMZ 
You can have up to 10 different events active at the same time. 


When you run a procedure containing WHEN, you create an “event.” In order to get rid of the programming of these 
special keys you can type 


CLEAREVENTS 


This command removes all programming from the keys until a procedure containing WHEN is run again. 
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Appendix 6: Operating System Primitives 


LogoWriter Version 2.0 uses the ProDOS operating system on the Apple or the IBM DOS operating system on IBM and 
IBM-compatible computers. On the Macintosh, these primitives work in System 6.0.2 or higher. There are a number of 
LogoWriter primitives that allow you to use DOS from within LogoWriter. These are discussed briefly below. 


To understand many of these primitives, you must understand pathnames. A pathname consists of a disk name, followed 
by any number of subdirectory names, followed by a file name. Disks can be given names. The pages that you put on a disk 
using LogoWriter are DOS files. If you want to group several files together, you can accomplish this by putting them in a 
directory. Using directories in LogoWriter is particularly useful. You can have a different SHAPES page in each directory, 
allowing you to have as many SHAPES pages on a disk as you wish! 


In ProDOS on the Apple, the forward slash (/) character is used to separate the parts of a pathname; in IBM DOS the 
backslash (\) character is used; in Macintosh, a colon (: ) is used; and in LogoWriter, the percent (%) sign is used. So, ina 
ProDOS environment, a pathname might be 


/MY .DISK/A. DIRECTORY /MY .FILE 
while in IBM DOS the pathname might be 
\MY .DISK\A. DIRECTORY \MY .FILE 
In LogoWriter you would use 

&%MY .DISK%A. DIRECTORY%MY. FILE 


The GS version uses the forward slash (/) character in pathnames. In Macintosh LogoWriter, vertical bars can be used. For 
example 


|MY .DISK:MY.FOLDER:MY.FILE| 


BYE (Apple only) 
This primitive lets you leave LogoWriter completely to go to another application. It automatically causes the page to be 


saved. 


CHDIR name/pathname (IBM only) 
Changes the directory for saving and loading pages. 


COPYFILE name/pathnamel name/pathname2 
This primitive allows you to make a copy of any page (file) from the Command Center. Thus you might type 


COPYFILE "SQUARES “MANY .SQUARES 


After this statement is run, you have two copies of the page SQUARE, one named SQUARE and the other named 
MANY.SQUARES. 


CREATEDIR pathname (Apple only) 
This command is used to create a directory (or subdirectory) on your disk. You might type 


CREATEDIR “%MY.DISK%MY .PAGES 


Now there is a directory on the disk entitled MY-PAGES. This directory can have its own SHAPES page and you can save 
pages within that directory. To copy a file into this directory, you might type 


COPYFILE "%MY.DISK%SQUARES "%MY .DISK%MY . PAGES*%MY . SQUARES 
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Now there is a copy of the page SQUARES that is found on the list in the Contents Page when you start LogoWriter in the 
MY.PAGES directory with the name MY.SQUARES. 


CURRENTDIR (IBM only) 
Reports the name of the current directory. 


DIRECTORIES 
DIRECTORIES is a reporter that returns a list of the current subdirectories on the disk. You can type 


SHOW DIRECTORIES 


to see a list of the directories in the Command Center. 


DISK (IBM and Apple only) 
Reports the disk drive currently in use (usually A or B). 


DISKSPACE (Mac only) 
Reports the number of bytes of space remaining on your disk. 


DOS (IBM only) 
Saves the page and leaves LogoWriter. 


ERASEFILE name/pathname 
This command allows you to remove a page from any directory on the disk. It is equivalent to using Erase to End of Line 
on the Contents Page. 


FILELIST 

FILELIST is a reporter that returns a list of all of the files on the current disk. This includes all files, not just LogoWriter 
pages (see Appendix 7). In the Macintosh version, FILELIST reports a list of lists. Each list contains the filename and its 
extension. 


FILETYPE name (GS only) 
FILETYPE reports the type of the named file, (e.g. “page,” “text,” “shapes,” etc.) 


LOADPIC name/pathname 
LOADPIC allows you to load any standardly saved graphics image to be loaded onto a LogoWriter page (see Appendix 7). 


LOADTEXT name/pathname 
LOADTEXT allows you to load a standardly saved ASCII text file to be loaded onto a LogoWriter page (see Appendix 7). 


MKDIR name/pathname (IBM only) 
Creates a subdirectory. This works like CREATEDIR (see above). 


ONLINE (Apple only) 
This reporter returns the names of the volumes (disks) that are currently available. If you type 


SHOW ONLINE 


a list of the names of the disks in the disk drive is reported. Note that they are in reverse order, i.e., Drive 1 is shown last. (The 
GS version also reports the number of devices connected to the computer.) 


PAGE (Macintosh only) 
Reports the name of the current page. 
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PREFIX (Apple only) 
This reporter returns the current volume or directory name. That is, it gives you the path name except for the page/file name. 


QUIT (Macintosh only) 
Leaves LogoWriter and goes to the Finder. (QUIT is equivalent to the Apple BYE.) 


RENAME name/pathnamel name/pathname2 
This command allows you to rename any file on disk. You might type 


RENAME "SMY.DISK%MY.DIR%MY.FILE "SMY.DISK%MY.DIR%YOUR.FILE 


to change the name of the file MY.FILE to YOUR.FILE. Note that MY.FILE is on disk MY.DISK and in subdirectory 
MY.DIR. 


RMDIR name/pathname (IBM and Macintosh) 
Removes a directory from the disk. 


SAVEPIC name/pathname 
This command allows you to save the image on the screen. The image is saved as a standard graphics image. This is the 
image you see when you use PRINTSCREEN (see Appendix 7). 


SAVETEXT 

This command saves any text on the page currently showing as an ASCII file. Note that it saves the text on the front of the 
page if that side is showing when SAVETEXT is typed, and saves the procedures only if the flip side is showing when 
SAVETEXT is typed. In Macintosh LogoWriter, SAVETEXT can be used to save only the selected text. 


SETDISK (Apple and IBM only) 
Tells LogoWriter which disk drive to use, for example, SETDISK “A or SETDISK “B. 


SETPREFIX pathname (Apple only) 
This command allows you to change the current prefix (see PREFIX). 


SETSLOT number (Apple Ile/IIc only) 
This command allows you to set the slot for the disk drive interface card. 


SLOT (Apple Ile/IIc only) 
This reporter returns the current slot for the disk drive interface card. 


- VERSION 
Reports the version number in most recent versions of LogoWriter. 


For more information on using subdirectories in LogoWriter, see Eadie Adamson’s column Logo Ideas in the September, 
1988, issue of Logo Exchange. 








Appendix 6: Operating System Primitives 227 


Appendix 7: Exchanging Files 


LogoWriter Version 2.0 saves standard graphics and text files. This means that LogoWriter files can be used with other 
applications and that files from other applications can be used with LogoWriter. 


Any application, such as a word processor, that can save standard ASCII (text) files can create files that can be used with 
LogoWriter. To move text from your word processor to LogoWriter: 
1. Save your document from your word processor as a text or ASCII file. 
2. Use the LOADTEXT command (see Appendix 6) to load the text into LogoWriter. 
3. Save your LogoWriter page. 


To move text from LogoWriter to another application, such as a word processor. 
1. Save the text on your page using SAVETEXT (see Appendix 6). 
2. Start your other application and load the text file. 


3. Save the document in your other application. 


Note that for each of these steps, you will have to use the file pathname in LogoWriter (see Appendix 6). 
Graphics images can also be moved between LogoWriter and other applications. (Macintosh LogoWriter uses PICT 
format.) To move a graphics image from another application to LogoWriter. 


1. Save your document from your other application. (You will need to check your documentation to be sure that it is saved as a 
standard file.) 


Use the LOADPIC command (see Appendix 6) to load the text into LogoWriter. 


Ww WN 


Save your LogoWriter page. 


To move a graphics image from LogoWriter to another application: 
1. Save the text on your page using SAVEPIC (see Appendix 6). 
2. Start your other application and load the graphics file. 


3. Save the document in your other application. 


Again, you will have to use the file pathname in LogoWriter. For more information on transporting text and graphics between 
LogoWriter and other applications, see “Logo Ideas” in the October, 1988, and December, 1988, issues of Logo Exchange. 


If you have a newer “superdrive” on your Macintosh, then you can use the Apple File Exchange that comes with your 
Macintosh system to transfer files from ProDOS (Apple) or MS DOS (IBM) to the Macintosh and to transfer files from the 
Macintosh to Apple or IBM. See your Macintosh documentation to learn how to use the Apple File Exchange. 
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Appendix 8: LogoWriter Keys 


Description of LogoWriter Keys 


General Purpose Keys 
MACINTOSH 


APPLE IBM 
Flips a page over 
Moves the cursor up from Command Center 
Moves cursor down into the Command Center 
Used to leave a page Shift-\- 98 


Stop Apple-S Ctrl-Break 3 -. 
Stops program or instruction; retums to 
Command Center (see also Esc 
Gets the Help page 


Contents Page Keys 
APPLE MACINTOSH 


IBM 
Moves cursor up and down through page that are Arrows Arrows Arrows 
in the scrapbook 
Moves the cursor to the top of the Contents list 


Bottom of Page Apple-Down Arrow 


Moves the cursor to the last page name in the 
Contents list 











Keturn/Enter 
Chooses the pate that the cursor is on 

Erase to End of Line Apple-6 
Erases the page named on the line that the 
cursor is on—permanently! 


Graphics Keys 
APPLE IBM MACINTOSH 


Turtle-Move | 
Makes it possible to move the turtle with the Arrow 
keys; Esc to leave 


Label 
Text typed is added to the picture; use Arrow keys to 
move; Esc to leave 
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Word-Processing Keys 


APPLE IBM 

Starts select mode; use Arrows to select 

Removes selected text; puts on the Clipboard 

Puts copy of selected text on the Clipboard 

Puts contents of the Clipboard at the cursor position 

Erases all text cursor from cursor to the end of line 

Displays the next screen of text 

; 

#-B 
#-E 
#-O 


MACINTOSH 


36 













Displays the previous screen of text 

Top of Page Apple- 3€-Up Arrow 
Moves the cursor to the beginning of the text on the Up Arrow 
page 

Bottom of Page Apple- 3€-Down Arrow 
Moves cursor to the end of the text on the page the Down Arrow 
cursor is on 

Beginning of Line Apple-B Ctrl <— 
Moves the cursor to the beginning of the line the 
cursor is on 
Moves the cursor to the end of the line, to where 
the next Ret nter was typed 
Opens new line after current cursor position 

i 2 i SS SPE 

Deletes the character under the cursor 
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Shapes Page Keys 
MACINTOSH 


APPLE IBM 
Esc Esc Esc 
Returns you to where you were when Shapes was 
chosen 
Flip Apple-F Ctrl-F 36-F 
Switches between the front (all shapes and 
individual shapes 


On the flip side of the page only: 


Displays the next shape for editing 
Displays the next shape for editing 


Arrow keys Arrow keys Arrow keys Click mouse 
Moves the shape cursor around the shape using the 
pointer tool. 


Empties or fills a space within a shape using the 
pointer tool. 
ere ran ee MN a 
Clears a shape and stores it in memo 
Stores a copy in memory without erasing it 
F 


n-3 
Paste Apple-4 n-4 3-4 or 98-V 
Puts a shape that been placed in memory into the 
shape that is displayed 
Stop Apple-S Ctrl-Break Click "Revert" 
Cancels editing; restores to the original shape 
before editing began 
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SUMMARY OF LOGOWRITER KEYS FOR THE APPLE Ile/IIc 


General Purpose Keys 











SR a a 












a ee 7 ee 















On the flip p 
Next Screen (Next Shape 
Previous Screen (Previous Shape 
Up, Down, Left, Right 
Space Bar 









side of the page only: 





Make or Erase Block . [| Space Bar 


Leave Label or Turtle-Move Esc 





Contents Keys 


Apple-Down Arrow 
Remove a Page (Erase to End of Line Apple-6 
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SUMMARY OF THE LOGOWRITER KEYS FOR THE IBM 


General Purpose Keys 








Stop 







Ns ee Se 
Bap nn = ee 








Word-Processing Keys 


















End of Line 


Shapes Page Keys 


Quit, leave page 


ee aa eee ee) Gan | ee own 
[Next Sencar 
. 





On the flip side of the page only: 


Next Screen (Next Shape 











Graphics Keys 


Leave Label or Turtle-Move 





Contents Keys 





Remove a Page (Erase to End of Line 
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SUMMARY OF LOGOWRITER KEYS FOR THE MACINTOSH 


General Purpose Keys 
[Down KD 


Quit, leave page Esc, Clear, or 9- 













gn es ee 





On the flip side of the page only: 





Graphics Keys 


Lae) KB 
Leave Label or Turtle-Move 












SUMMARY OF LOGOWRITER KEYS FOR THE COMMODORE 


General Purpose Keys 











aaa (NRE ee 
[Down Commodiore-D__| 
ee a 












Up Arrow 
Down Arrow 


End of Line 



























On the flip side of the page only: 













Leave Label or Turtle-Move 


Contents Keys 


Top of Page Commodore- 
Up Arrow 









Bottom of Page Commodore- 
Down Arrow 


Remove a Page (Erase to End of Line 
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-/I-Z ~SesS 
a "eA et” a 
a) 
For the COMMODORE 64° 


2 ae 


LABEL TURTLE-MOVE HELP 














Fes 
SELECT COPY PASTE ee ee 





IBM PC @> CiBreak  GariD Cure CtrrU Pg Up 
7 Fy ed 
: STOP DOWN FLIP UP PREVIOUS _NEXT 


SCREEN SCREEN 












eee 


SELECT UT ry PASTE ERASE TO LABEL TURTLE-MOVE HELP 
END OF LINE 





IBM PC j @» Fo Cir D Cir F Cin U 
Bs Ee Ld ow ‘Yo 


STOP DOWN P uP PREVIOUS NEXT 
For the IBM PCy SCREEN _ SCREEN 
















Fn3 Fn4 
Bm RQ CS 
ae | 7 
SELECT CUT COPY PASTE ERASE TO LABEL TURTLE-MOVE HELP 





END OF LINE 


os Ile and Hs ee 


ee 3 


ji For ihe Asie” lle * ang tic ~ 












Sapa ae 


PRENIOUS 






SELECT LABEL TURTLE-MOVE HELP 


Appendix 8: LogoWriter Keys 


biasieaee 9: Shapes waa 











These keyboard stickers are available from Logo Computer Systems, Inc. 
Call the sales office at 1-800-321-5646 for information on how to order. 


Primary 


1 2 3 4 5 6 fa 3 9 18 
Om EE] ae st w = ah -= 
11 


12 13 14 15 16 17 18 19 26 
>ewe ax i= s 


22 23 24 25 26 27% 28 29 38 


Oc dhs 


Intermediate 


11 12 13 14 15 16 17 #18 19 26 
Me<vOtnz+ 


21 22 23 24 25 26 2g 3G 


OY Sp BS Se, SE wh Ge GR EE III 
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Macintosh Intermediate 





1 2 3 4 5 6 7 8 9 10 
17 18 
27 28 
G> ek 
37 38 39 40 
47 2555 ra * 
< 8 Se 
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Appendix 10: Quick Reference 


LogoWriter Primitives and Special Words 
* Primitive is a reporter (operator). 
# Primitive is either a command or a reporter. 


Screen Input/Output 
CC—Clear Command center * BUTTON? button number (Mac—no input) 
CG—Clear Graphics CLEARCOM (Mac Only) 
CPp—Clear Page * KEY? 
CT—Clear Text PADDLE nuwmnber (IBM and Apple only) 
* READCHAR (Mac only) 
Scrapbook * READLIST (RL) 
CLEARTOOLS * READLISTCC (RLCC) 
CONTENTS RECEIVECHAR (RCCC) 
DOS (IBM only) SEND wordllist (Mac only) 
ERPAGE pagename—ERase Page SETBAND number (Mac only) 
FLIP SETCF word! word2 (Mac only) 
* FRONT? 
GETPAGE (GP) pagename Assigning 
GETSHAPES pagename (Mac Only) CLEARNAME word/list 
GETSOMESHAPES pagename list (Mac Only) CLEARNAMES 
GETTOOLS pagename MAKE name wordlist 
LEA VEPAGE NAME wordlist name 
LOAD pagename * NAME? word 
LOCK (Mac only) PRINTNAMES 
NAMEPAGE (NP) pagename SHOWNAMES 
NEWPAGE THING names 
* PAGELIST 
RESTORE Printer Commands 
SAVEPAGE DSPACE—Double SPACE (IBM and Apple only) 
SHAPES 
* TOOLLIST PRINTSCREEN 
UNDO (IBM and Apple only) PRINTTEXT 
UNLOCK PRINTTEXT80 (IBM and Apple only) 
SSPACE—Single SPACE (IBM and Apple only) 
Workspace 
RECYCLE Special Words 
* SPACE END 
FALSE 
Timing HELP pagename (Mac only) 
CLOCK (Mac Only) STARTUP 
RESET (Mac Only) TO 
TIMER (Mac Only) TRUE 
WAIT number 
System Modifying Primitives (IBM/Apple) 
Sound -BLOAD name/pathname address 


ERSOUND name (Mac Only) 


-BSAVE name/pathname address length 


PLAY name (Mac Only) CALL address 
RECORD name number (Mac Only) .DEPOSIT address byte 
SOUNDLIST (Mac Only) * EXAMINE address 


TONE frequency time 
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Flow of Control/Logic Graphics 


* AND rrueffalsel true/false2 * ALL 
CAREFULLY list] list2 # ASK turtle/turtle.list list.to.run 
ERRORMESSAGE (Mac Only) BACK (BK) number 
ERRORNUMBER (Mac Only) * BG 
* TF truelfalse list to run CHANGECOLOR number list of three numbers (GS) 
# IFELSE true/false list.to.run1 list.to.run2 * CHARUNDER - CHARacter UNDER 
LOCAL wordllist (Mac Only) CLEAN 
* NOT true/false * COLOR 
* OR rruelfalsel true/false2 * COLORUNDER 
OUTPUT (OP) word/list * COLORVALUE nwmnber (GS) 
REPEAT number list.to.run * CURSORPOS 
RUN list.to.run * DISTANCE list of two numbers (GS/IBM/Mac) 
STOP EACH iist.to.run 
STOPALL FASTTURTLE (GS/Mac) 
FILL 
Math (Note: all are reporters) FORWARD (FD) number 
+ - * / (Mac only) HEADING 
> < = HOME 
o> <= m= \ A HT—Hide Turtle 
ABS number (Mac only) LABEL word/list 
ARCTAN aumber LEFT (LT) nwmber 
COS degrees MOUSEPOS (Mac Only) 
DIFFERENCE number1 number2 (Mac Only) PD—Pen Down 
E (Mac Only) PE—Pen Erase 
EXP number (Mac Only) * POS 
GREATER? number! number2 (Mac Only) PU—Pen Up 
INT number PX—Pen Reverse 
LESS? numberl number2 (Mac Only) RESETCOLORS (GS) 
LN awmnber (Mac Only) RG—Reset Graphics 
LOG number! number2 (Mac Only) RIGHT (RT) number 
PI (Mac Only) SETBG number 
POWER number! number2 (Mac Only) SETC number 
PRODUCT number! number2 (Mac Only) SETH nwmber 
QUOTIENT nwmber! number2 (Mac Only) SETPOS [x y/] 
RERANDOM (Mac Only) SETSH number 
RANDOM number SETX number 
ROUND number SETY number 
SETNF number (Mac Only) SHADE 
SETPOINT (Mac Only) * SHAPE 
SETCOMMA (Mac Only) SLOWTURTLE (GS/Mac) 
SIN degrees ST—Show Turtle 
SQRT number STAMP 
SUM number! number2 (Mac Only) TELL turtle/turtle.list 
TAN number TOUCHING? (Mac Only) 
* TOWARDS list 
Events * WHO 
CLEAREVENTS WINDOW 
PRINTEVENTS (Mac Only) WRAP 
SHOWEVENTS (Mac Only) XCOR 
WHEN letter list.to.run YCOR 
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Te 
cg 


* 
* 


* &© © H 


*% £2 &© & #8 


* 
* 


xt Editing/Words and Lists 


ASCII char 

BOTTOM 

BUTFIRST (BF) word/list 
BUTLAST (BL) wordlist 
CB—Cursor Back 
CD—Cursor Down 
CF—Cursor Forward 
CHAR 

CLIPBOARD 

COPY 

COUNT 

CU—Cursor Up 
CURSORCHAR 

CUT 

DELETE 

EMPTY? wordlist 

EOL 

EQUAL? wordlist] word/list2 
FIRST word/list 

FOUND? 

FPUT word/list list 
IDENTICAL? word/list] word/list2 
INSERT wordlist 

ITEM number wordllist 
LAST wordllist 

LIST word/list] word/list2 
LIST? word/list 

LPUT word/list list 
MEMBER? word/list] word/list2 
NEXTSCREEN 
NUMBER? 

PARSE word 

PASTE 

PRESCREEN 

PRINT (PR) word/list 
REPLACE word! word2 
SEARCH word 

SELECT 

SELECTED 

SENTENCE (SE) word/list] word/list2 
SETEXTPOS number 
SETTC number (GS) 
SHOW wordlist 
SOL—Start Of Line 

TAB 

TC (GS) 

TEXTLEN 

TEXTPOS 

TOP3 

TYPE word/list 
UNSELECT 

WORD word! word2 
WORD? word/list 


Disk (Apple or IBM) 


* 


DISK 
SETDISK letter 
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ProDos Primitives 


BYE 

COPYFILE name/pathname! name/pathname2 
CREATEDIR pathname 

DIRECTORIES 

DISK (Mac only) 

ERASEFILE name/pathname 

FILELIST 

LOADPIC name/pathname 

LOADTEXT name/pathname 

ONLINE 


* PREFIX 


* 
* 


RENAME name/pathnamel namelpathname2 
SAVEPIC name/pathname 

SAVETEXT name/path 

SETDISK word 

SETPREFIX pathname 

SETSLOT 

SLOT 

. VERSION 


IBM DOS Primitives 


* 


CHDIR name/pathname 
COPYFILE name/pathname1 
CURRENTDIR 
DIRECTORIES 

DISK 

DOS 

ERASEFILE name/pathname 
FILELIST 

LOADPIC name/pathname 
LOADTEXT name/pathname 
MKDIR pathname 

RENAME name/pathname! name/pathname2 
RMDIR 

SAVEPIC name/pathname 

SAVETEXT name/pathname 

SETDISK word 

. VERSION 


name/pathname2 


Macintosh Primitives 


COPYFILE name/pathname! name/pathname2 
CREATEDIR pathname 

DIRECTIONS 

DISKSPACE 

ERASEFILE filename 

FILELIST 

LOADPIC filename/pagename 

LOADTEXT filename/pagename 

ONLINE 

PAGE 

PREFIX 

QUIT 

RENAME name/pathnamel name/pathname2 
RMDIR name 

SAVEPIC name/pathname 

SAVETEXT filename 

. VERSION 
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Math Primitives 


number/ \number 
\is the equivalent of REMAINDER 


ABS number 
ABS reports the absolute value of its input. 


DIFFERENCE number! number2 
DIFFERENCE is the prefix form of the subtraction sign (-). It takes two numbers as input and reports the result of subtracting 
the second input from the first one. 


E 
Reports the value of the transcendental number e. 


EXP number 
EXP takes one number as input. It reports the number e raised to the power of the input to EXP. This is the inverse of LN. 


LN number 
LN reports the natural logarithm of its input. This is the inverse of EXP. 


LOG number (or numberl number2) 
LOG reports the logarithm of its input in base 10. 


PI 
Reports the value of 7. 


POWER number! number2 
Reports the value of the first input raised to the second input. 


PRODUCT number! number2 
This is the prefix form of the multiplication sign (*). It reports the product of its two inputs. 


QUOTIENT number! number2 
QUOTIENT reports the result of dividing the first input by the second input. Division by zero gives an error. This is the prefix 
form of the division sign (/). 


SETNF number 

This primitive takes one input and sets the number of digits displayed after the decimal point. The default is for LogoWriter to 
display 4 digits. SETNF does not affect the precision of Macintosh LogoWriter. It always uses 16 digits for computations. 
Macintosh LogoWriter can also display numbers in scientific notation. For example 1.0E10 means 1010. 


SETPOINT 
Causes LogoWriter to use a decimal to separate the integer part from the fractional part of a number. 


SETCOMMA 
Causes LogoWriter to use a comma to separate the integer part from the fractional part of a number. 


SUM number! number2 
This is the prefix form of the addition sign (+). It reports the sum of the two input numbers. 


TAN number 
TAN reports the tangent of its input in degrees. 
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Flow of Control and Logic 


CAREFULLY list] list2 

CAREFULLY takes two lists as inputs. The first input is a list of instructions that is run. If there is an error while this list is 
running, the second list is run. If there is no error in the first list, the second is ignored and ERRORNUMBER is set to 0 while 
ERRORMESSAGE is an empty word. 


ERRORMESSAGE 
This reporter returns the most recent error message. 


ERRORNUMBER 
This reporter retums the number of the most recent error message. 


%-H 
Pressing this key combination causes the current procedure to pause. Pressing any key causes it to begin again. 


Time 
CLOCK 
This reporter returns a list containing the date and the time in the format [10/19/89 4:30:55 PM] 
RESETT 
Resets the timer to 0. 
TIMER 


This primitive reports the duration, in 60ths of a second, since the last RESETT command. 


Help 
HELP 
The HELP primitive allows you to create your own Help page. It takes one input, the name of a page. The page can be looked at 
but not changed. 


Help Menu 

Under the Apple Menu at the left edge of the menu bar are two choices for help. The “Help Page...” option gets a page named 
help. The “‘Help Primitives...” displays a list of all the primitives in Macintosh LogoWriter in alphabetical order. Clicking on 
one of the primitives in the list causes a description of that primitive to appear. 


Sound 


ERSOUND sound 
This command takes the name of a sound resource as input and erases it. 


PLAY sound 
This command takes one input and plays the named sound resource. 


RECORD sound duration 
This command takes two inputs, a name and a number. The first input is the name to be used to save a recorded sound. The 
second is the number of seconds to be recorded. This command works with Macintosh models with built in microphones. 


SOUNDLIST 
Reports the list of current sound resources. 
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Communication 


CLEAR COM 
Clears the communication line. 


RECEIVECHAR, RECC 
This reporter returns the character being received through the communication channel. If no character is being received, 
LogoWriter waits for a character. 


SEND wordlist 
This command sends a word or a list through the communication line. It does not send a carriage return following the input. 


SETBAUD number 
This command takes a number as input. This number must be one of the following baud rates: 300, 1200, 2400, 4800, 9600, 
19200. The default value is 4800. 


SETCF 
This command takes two inputs and sets the communication format. The first input is the category; the second input is the value. 
Here are the possible values: 


Miscellaneous 


BUTTON? 
Reports true if mouse button has been clicked. 


MOUSE POS 
Returns the position of the mouse in turtle coordinates. 


PRIMITIVES 
This reports a list of all of the primitives in LogoWriter. 
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Appendix 12: New Macintosh Features 


The Macintosh version of LogoWriter includes a number of new capabilities that are accessed through the Utilities menu on 
the Menu bar. Each one is briefly explained below. 


Gadgets 
This choice brings up a window with six gadgets, described below, that you can use. They all apply to the movement or 
angle of the turtle. 


Plot Heading 
When you select Plot Heading from the Utilities menu, you see a small window containing the turtle. 


You can move this window anywhere on the page. As the turtle turns, this window displays the direction of the turtle. Thus, if 
you have the turtle set to a shape that doesn’t rotate, you can use this window to tell which direction the turtle is facing. 


Measure Length 
If you check Measure Length, then you see a window that shows the distance between the turtle and the point where the 
mouse is clicked. The window that appears can be moved anywhere in the Command Center. 


Distance: 





Moving the mouse pointer to the page causes it to change to a pointing hand. Clicking the mouse causes a line to be drawn 
from the “hand” to the turtle. 


Plot Angle Sweep 
Selecting Plot Angle Sweep causes a small window to appear which you can move anywhere on the page. It displays the 
change in the heading of the turtle since you selected Plot Sweep. Thus if you select Plot Sweep and then type 


RIGHT 90 
RIGHT 180 
LEFT 90 


you see 
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The length of the line (in turtle steps) appears in the Distance window. Click “clear” to start again or “continue” to get rid of the 
Distance window. 


Measure Angle 
When you check Measure Angle, this window appears in the Command Center. It can be moved anywhere in the Command 
Center by using the mouse. 





Moving the mouse pointer to the page causes a pointing hand to appear. Clicking the mouse button displays the angle between 
the position of the hand and the current heading of the turtle. The number of degrees is displayed in the Degrees window. 


Click “clear” to start again or “continue” to get rid of the Degrees window. 


Slide Length 
Choosing Slide Length causes this window to appear in the Command Center: 





If you drag the small rectangle to the right by using the mouse, the turtle moves in the direction it is currently facing. Clicking 
“undo” erases the line drawn by the turtle and puts it back where you started when you selected this option. Clicking “reset” 
causes the slide to start again from the turtle’s “current” position. Click “continue” to get rid of the Slide window. 


SSS Se eS 
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Rotate Angle 

Rotate Angle is used to change the heading of the turtle. Click on the small knob on the outside of the circle in the Rotate 
window. The turtle turns as you move the knob. The picture below shows the window when the turtle has been tuned 60 
degrees. 





Click “reset” to put the turtle back to the heading where it began. Click “continue” to get rid of the Rotate Angle window. 


Pics... 
This menu choice brings up a window allowing you to select five options for working with SAVEPIC and LOADPIC. 


Set Position 

If this choice is unchecked, then SAVEPIC and LOADPIC work the same as in other versions of LogoWriter. If they are 
checked, both SAVEPIC and LOADPIC cause a beep. The mouse pointer turns into a cross. You then drag across a graphic 
area to save if you are using SAVEPIC. If you are using LOADPIC, you drag across an area where you want a picture loaded. 


Merge Image 
When “Merge Image” is checked, LOADPIC merges the image on the screen with the one being loaded. If this option is not 
checked, then LOADPIC erases the image currently on the screen. 


Conform Size 
If this option is checked, then the entire image being loaded will be scaled to fit in the area defined when you use LOADPIC 
with Position checked. 


Frame Image 
When this option is checked, the images loaded using LOADPIC are framed. 


Align Image 
This option allows you to line a picture up with one of the four corners of the page or with the center of the location where it 
is to be loaded. This option is not available when Conform Size is checked. 


Sound... 


This option brings up a dialog box that you can use for a recording session. You can start, pause, and end a recording 
session. If you choose to save the sound, another dialog box allows you to name it. 


Print Color 


When this option is checked, the Print Screen menu option and the PRINTSCREEN command print in color. An 
ImageWnriter II can print only six colors. 


Print Enlarged 
Checking this option causes the printing of graphics to be enlarged. The printing of text is not affected. 
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Confirm Save 


When “Confirm Save” is checked and you save a page, LogoWriter asks whether or not you want to save the changes you 
have made to the page. There are a number of ways to close a page on the Macintosh: 


* Click on the Close box 

¢ Press 9-W 

* Choose the Close option in the File menu 

¢ Choose a page command in the File menu 

¢ Press Escape (or the equivalent keys) 

¢ Type GETPAGE, NEWPAGE, or SAVEPAGE 


252 Appendix 12: New Macintosh Features 











 heocetteeiees eat cletuesicsspcen Suibbesmraiuay Sioiyee Cain geclouwa nas aleameniwwnatine BO GOB isk secdencriees tanh tedeumie snes aie enasivanteeainnoarsneeadiicge's 165 

(. Vistestes cxeincick eetoeceummmesinsakianes cesarean qraaenan ere 15580) (CD haicicen sons tree sed entwener aay eeaeai aterm eionaats 165 
for multiple inputs ...............c.cscceeesseeceseeceeeeees TO3 OR eine ie devevs cesisiinasidetosiced acigatlopleeaarditanmaiadcemcgiasadacnns 164 

Fs Shidusis ctigamemaes Sasuiavanieis wai aeseeneshides eabeaenndeneseneeuere 153: - CG gi eceschowics sean cone nce vay taiasocieiancentn edly cee anieersanes 8 

sWERSION spicevwcsnona ete suave aeuetecssaseiereawconmney 227 CHANGECOLOR 

if ssisccsvnniting Obs idia wbinbtoe ddag ioe aeee ooeesRs oats aut saee eae SoA Tees 153 ON the GS veces ce endorser nteaseresainateseeiearvess 19 

ii asssihio ie iuic wanape sale SerSesdtbsnwidatbie cnrnialeeiestalsias slnpines at solasinaisicl sie 154 CHAR 
BSA PROGIC MG a ooa6 wires spwcteaoietnsenine senedaeys weestisesies's’ 189 for Regu Mel iss scasesins samesincexennsesanes vereeeeres 103 

1S miisinnadenresiincints dereteetrasiee eaeewunteganaseeatensieseietmeces 9 CHAR 

Si ciat nad soun onus caeenenenenavenoonsies veasecepent ovens avenss 98, 154 FOO. SPACE swssasisicasscewsdiize sires dvds neawmend eek ten uin neste % 
DSA PRCCICANS c's sissindeciansaccapismewe sadness denuacuseveds 189 Character 

Ds. Suagnvian daenocoe dau ameumtote nets cindwoncglea cunbbonataedobeathe 97, 154 QUOUN Gs. csscsonutossenccrageoeseaetiocmeesesneeentcoauwows &2 
AS A PLediCale ........ esc secececececeeeeeeececeeeeessenens 189 under the CUISOF ..............0cececececececneeeeeeseeeees 175 

[9] cerersltearascaeame sets nna harcore aul manatee Setomdebeatmeaeinees 15,80 Characters 

N sist sjsa deca Biena ie nele sage Ad dime’ a sald etme Speldecine siaiee SR Hem ambenNe Rees 82 MNUMbBET IN A WOTKL........eeeeeeeeseeserereeneeceeeeeees 201 

lL ndaantdchb uanaabotenaiment shite outtretenendtuatiadseametatdees 82,205 Checking conditions..................ccceceececeseceeeeeeeeeees % 

Choices 

Active turtles AMOS gare aaeresiese cee duronterews varcentetineateesdevianns sgomteoes 125 
IGENGEYING sisisisecsesscenaswsdendennwscasnews ae sanserr cue 76. CLEAREVENTSS sisicess scsi oven iaica vanesens saawsamcens vasaann ce 224 

ANIELS siscesasia'siierrembe aslatocee ve eaene dududesemeasmanensseuaceesacantinese 74 ~— Clearing the graphics screen..............cccscescseeeescecesceees 8 

AND) vicars deine biesit side's x vintesciv'uenlsoeiu tins etinstienemeseigeiseotatens 190 — Clearing the page .................eeeeceseseeeeeeeeesonecoeees 113 

AMUMADON scans taataues sawn Genaniaieden aawnoeeeceies eet ats 91; “CLEARNAME oes sicassesanerccirav sites cies sons anesumnnens eenguen ds 180 
CHECKIN Gicnssassasvinscpessanctimsas vin eonctsaxtsanias sonswes 92. .CLEARNAMES is: cencteciawes cand cara tae scaneemseeemaunese a 180 
CTEALN BS s'ssirsinsicrenescidte sists vise sidaect aces cvicajeasicnuioseaes 92° CLEARTOOELS iin secs a ssteeisvinbsibnnaaidesd owen sareartnd deiduens oe 221 

AMmimation and MUSIC ..............ceceeeeeeceeceecsceceeeeseeees - CLIPBOARD cccnciicnsiaenevonssiccanaceded covianutaniowecnes 172 

Arithmetic and SELECTED '.c:.csvesins siasnomnteanin sewsiondaeny snekugy oe 173 
If LOGO x2 socncesvsmsiacmsinanawsasign csemsncciwascecemn omnes 153. CONE sccacesasooxi cms ewan cater aseacues viteue cone ana vex lads warren oe 159 

ASS Kvisituisnsensew anand ecebcnanontwcieacs Hews sebiesiec suetaus deeante 132 DACKQIOUNG........ eee cece ee cecceecscceceseceeeees 18 
CX PlANAHON: 55. nccccnsccnsercececenerseeeeenseereverdeerienegy 135 Fling: With srscsccccceesccveenesneenenetesasceeesued deeeuerey 2 
WHEN 10 US6 se ccssessscoteveccecanecuscosssenwenesenseessees 135 ON. hE GS crcssinccosisduoenssemcastoncseeesaviuswueseeeasesay 19 

On he MaCIniOSN 5. scasdsecsincsswer sivas onsicaveoowsssns daceses 18 

Backspace Problems With... cee eeeecceeeeteeseeeeeeees 2 
AN Dl tassiccrinspicwenias aewiannengeevonenvarenms uaa agai’ 168 Colored text 

BR vesinetsansasneaantaaamome vont ont tnmomeeeaes umsesins easreterecsows 195 GN. “MC  GSseccsteiccecesticare sivotanccsetenescives cenyes 37 

BiG ivicn cisnicecaisineauaiae deste duinesaee cenetamsinns act aceailetant annincseee GF} = ~—§ COLORUNDER isis nciasssceasisinesocs coonennn ase’ dade esata ste 159 

Biluiciccutesnipainaelies saves sninninnasdeueinatieasosSeuinsiannsuneasenusrencnns 195 COLORVALUE 

Body centered COMMANAS................sesesceeeseeseeeeeees 183 ON: NE GS vec teeecisncssesecnedd uccdiep Savteuw esiecaun iatieaee 2 

BOT TO M esisascenstvses setavseas mac wecwesterentieceasonies 164,167 Command 

Bottom up programming ...............sceceeeeeeeeeeseeeeeenees 51 ME TINILOT OF 0 aces nstciasis apenas niga slates Ubjos bitin imemivece gactibe 81 

BUGS: srsicsaiseishawisiarajedicalcle ole awtaninsrec anteiee cela dlea seficistneaaie Dainiacione'tin 49 Command Center 

BUTEIRST eragetedcietisencuabesmmaneccnveaeuiberyeis vesis nants davies 195 MC FIME Us sin cic wesapraadae astnastnegieaeaauunaay edi iat yells aint 8 

BUTLAST 1 sassiwsis csnacrrnsanenmesieesdsien etaweiaepenaies tees eae 195 | Commands 

BEY Bee osoicsiscch caicdes ccsmaiosieita cate anaa ban ance athaga reap dans eeacie s 225 body CEMEred soiéss.sec cnx oven cpus cans susawedeaien smcaens oe 183 

KOOP ING occ ctienies structs adiscibincarn amie anitsiitoinemiemit meted 41 

Cartesian COMMANAS ..............scceceeeeeesseeceeeessecneeees 183 Comments 

Cartesian reporters INSETLING IN PTOCECUIES................cceeeesesesssseeeeess 48 
used in debugging ................ecccseeeceeseeeeeeeeeeees 186 Conditions 

CASE Statement z.330s:i0 dp-gsisienlniciticae eine csi deliviniennis saWnnilew sini 125 CHECKING isis ercit ciadiiiawi caine Geinitiodiamrgniowaiah aie dhagerdaisuinarsre 8 

Categories of procedures ...............ceceecseeeesececeeseneees 81 Configuring disks..................0+ 211, 212, 213, 214, 215 

Cautions Confirm Save 
when USING iMPULS .............-cceeeeeeeeeeeceeeeeeee eens 126 Macintosh only .............ceseeeseecesceccecssessessesees 252 

Index 253 








CONTENTS ssccuasecis antosses uceecomannnnecteamnaniuewey DUT DISK SesSoccssensdsctensdensesotienpeteuvienstenabectnanutee 226 
without using ESC.......00...ccccccsseceeeseeeeeeeeeesues 111 MESO tcccs cessinsers cen ewssacat 2intienactnnans smmandocanions 3 
aN PAG sins soins Sasstnictsasardanieaisde ansiommcemaansice 3,4 SCTAPDOOK......1-sseseeeeereeeesetetseseeseseeseeseeesesees 3 
Coordinates DISKS 2 
CAMESIAN Jiviei crocs seus sane send vee tees eeseeaes ieeieheeeats 183 COMFQUTING -s--nrnsenernerssnne ners Bl t2, BIS, 218 25 
DISKS PACE is ssssavvsirant eecswevahnanextsastan ities ednesetees 226 
Of CURSOF Sascesncscsenssis sues sseesenstanenans mmmemearansen 175 DISTANCE oocooeeccoeccccccecesecececoococeoccccscccesccc. 186 
OF thé: turtlévesccoss seed ccecisstemantaminseiecta 47 ID ViNSG A SUD rca cia cesspccsacse cdccsamesndes Geceki scorn lenameccave 153 
SCTEEN es eesesesseneessnssesereesescetencecentecesensasensees AS «a NE MA ne 225, 226 
COPYFILE «....0.sssseseeseseeeeeeenerescacesereeeeetsecacaees OD A TNS ca hs nck tebe take sote Sg cppacsnc indicat 179 
Copying Shapes ..........ssseseseeesereseesssereseseeitecseeees = Doublle: Spacing. ...aseessesaneessnecceswecucey snyveon viosinevens % 
to another disk .......+..eeseseeeeseseeeesesteeeeteneeeeseees > TNS MN paca emsenborgni asco cso ares eg toate 9 
COPYING EXE aac ssicsasapes heaws cepa tesntesticng enor venveraveteankes 6l Duration 
Command Center .......-..sssssesesesereeeeseseeeeeeeneees 6 a aT OUT ORC ee @ 
TNO SHANE scinncscsiinpiccscens seainnceti ep ten sacilameininnaanodetas kai @ Dynamic scoping 
COS Pree r eee ee eee ereereer err errr errr rr err eer re ererre errr rere rer 154 explanation of rie debbie thot Bg NaN Lee ay Dt 179 
COUNT wocscsstiss vaonetce sasac's win semsoeed sans ovai cipeueaconposus 201 
Counting id otaisiaialeiorave-wiatsisinieiorstareie aio 'ereleroinisieloiwialaiatare ieisiererwlele’eie’e:ticrelvie’er 143 BAC Houses oiiceotesck deSoanted swesonianaices eodouetareuacimecnction 131 
Rc ks ee cree eee ee A 113 ae c oie ta 35 
CREATEDIR sede savssenscass seunaneawass aveteons nowecdeeiwendees 225 GHEE ie fe a th ees 135 
Creating lists ...........ssseeesseesreeseesseesseessesssseeenenes A | | EN LPR 42 
Creating NAMES: 22 552scccssceesne soe cnieniecese dsinewais sosascnsdinns 179 Embedded recufSioN ....0.0.-eecocececeeeeecceeeccceecce,, 89, 149 
CU eee CeCe CeCe ere ee eee eee eee eee Cer e errr ree eee eee eee eee eee eee 164 caution against ie Spd hla fn Sure oO Pana th i Pn RA ad SS 1 17 
CURREGT DIR vi acsiconaincosissiouis envaaunanacachd wosiliass'vsto' 226 ernntaderecaletiiel. acess anscocamsoncamreee omic 51 
Cursor Example Of......eccceccssesesesceseseseecsecsvscecersceees 17 
CAPAC UNGET ..5.0cseseccsesssscesssesonseecoseswessncess 175 
Tae) oo... sees eeeeeeeeeeeeeeeneeceeseeeesseeeeesseeeeaeeees 13 importance Of ..........ccecceecsesscesecesceesccesccescesscs 4B 
location in turtle coordinates..............sssseseesereees CL. | ee TT SERS: 165 
LOCALION: “OL cisccccsatcnson sdanaacdsccoerecodesvtsessnsedecsiss 174 End of paragraph ........cccecccecccescceseessccsscessceseeses 165 
moving using COMMANAS ..........++.++seeereeeeeeeeeeee BO Mg scram sire ha ia aac ae Sack 165 
CURSOR DACK es sacsasaceceneiiasiedauis ious eeieenamenent seis cenneeae ens 165 CT a As eNOS eT 165 
CUPSOP) GOW s..0c.ccccasiescantacevinseseaenmeconsenssindeivedecoetis 165 BI ooo cha ype dy vcd desde dca cso 189 
Cursor forward ........ssseseseeeesseserentnensnseeseeenentnees NO ERAGE RIL Boscpicsascssnnsanainsasanaciacinenncasevinsonensvsntns 226 
Cursor location FSGS TUNES ce conwresans amtaranad exceeswivennn sas Saas sieaundinnnet dseadt 9 
si acess ue asia i a aise aaa ar aaa VIS Brasing PageS......sssssessssesssseessssssssseesssesssesssssees 112 
CUTSOL UP sereereeeeserseesrescsersnreenerneennsenceecenecencensens DES BG hake cd inceants ssubdaarnaacsacanepald Setadiegh 112 
CURSORCHAR Esc 
IBM and Macintosh .............c.csesscscssceeecssceeeees 175 Macintosh equivalents ............sss:ccsseeeeccecceeseneeees 9 
CURSORPOS .......ssseseeessesteteetseneeeseteeteteeseneeey OY SAISTTN cot acs aca cstaibl olan Saat dace 23 
Cut Hae EL IE yo seca valence es di seiebaeiatk 
USING COMMANAS..............eeesseeeceeecerecesceeceeeeees 168 neo sl 
Cutting shapes 0:00:08 t06'6ie 6/0104) 0/00 0106 Seed e ese ce eceseeeesocece cones 65 FASTTURTLE 
CULLING: COX Ei cscrinvssiecnigneiaievsialsasicdess'esiesi'iies’s vnspiledeesiciva'’s 6l on the MacintOSh ..........ccccccccececececeececccecceeeeece » 
. BADD ssa vo catesid ve slde gain Canis Cae bataoonduahaenidswes Aovedtaatears wet 7 
Debugging ..........ssssescessesseseeseeteseseesensesenseeaeees Be «SATE SEAUNS Tylscentseescit essed heroes bisa Case asp sae 26 
using Cartesian reporters ..............0eeeeseeeeeceeoeees 186 Files 
DSIN PRINT os wsissrsiocsdins suaissieials pis ostrecieing ssiestice 94, 126 text 
Decisions exchanging with other software..................0. 229 
~~ ee seeeseseeenencaeseeatasnenneaceneneneaeeesncneeeeney Ss SI VME chasctewsncesiionnsiespioa intentses eas ocee Ae 226 
inite loop FULD pases ceismectsamainesceisisaia suemanme yitvatenis netretetie poor dulns a8 2 
defined WS WInicles eeiears Siar aieicivie cine eels paisiateremisiesareiesonie ae 87, 88, 89 problems WALLIN. cSciea'de'sesesdctoucaahewicdesiethamtextcawnebe 29, 31 
Definite loops Frindiniey WGC scnve sinincnecincianernemiica datisnanisommaweniages 15 
TL Pt "SIAN enti site ncibhnims tdebebsanmalgtond onaAiv cesses 195 
Problems  Witlisesccscsiscactssnceonswcsssnezenersaveensicens 196 
DEISE TE iced acdousosisstnnisaddenbeuiasna bale siecdatioasseas acieseseese 168 | cS NN Sa SAIL iI NY RS NRE RS 113 
BND BACKSPAaCOs.<ccicvnsescsosavesvscecertsemeseneassemsecs 168 Flip side 
Delete KOY sow ssaas suuieeans somrermase clas emename@ eae osidueted sereesexeres 36 OF Shape Papes..eicsssrnsernvceviervcirreacsernavnearsunvens oa) 
Deleting text GO PRs RR tices eee ong dciarlon 4 
POODICMS o.5.s20icnior caesssinnisesowns anes ows temeiees corneas 37 Flipping the page 
DIRECTORIES vesigaesineni vetwenasacanarcesvesenartnetennendaaes 226 from the Command Center ......-...ccecccccccecceececeee 113 
254 Index 








Fonts UNSER Fis. so isse Severs de aerncsasenstaraunsaveuindeaaeene wees 101 
ON the Macintosh... eeeeseseeeeeeeeresseeeeeoeee 37 and PRINT compared................eceessssssssssseeeees 101 
FORWARD ives: sees cone son cscs ees sacs taaeemnessevaasauescmeasen 7 and TYPE compared .................ceeceeeeeeeeeeeeeees 102 
POUND) ions senscrsesacicnsinasinne an sdenaede taeiedinen sents aamnisierentes 189 _Interactive 
PR UT ssccssoeicasjesisincis cidiasioelae/ese stein veoulsiidee jas caine arto etic vartenee 209 Gefinition Of ............. cc ceeeeeeeeeece sees 83, 84, 85, 86 
Interactive prograMMiNg...............ccecessceceeeeeeeeeeeees 105 
Gadgets Interactive reporters 
Macintosh only .............c.ecececcececescscececesceeeeees 249 WHEN 10 USC sisi gadissinsminedownswsscansevadouad ena nenesmetents 109 
GETPAGE .. 2: cecisccieneneseetaonainectvennacdaadestazear seins VIZ 5219) “TEM seasainscnedexcadisn ctsmnene deuiemdaertelececsioa saan aanvoecenas 201 
GETSHAPES  essecans ixcasnns sonieranwams woes cuar eho waeeiaes 113 stems 
GETSOMESHAPES Number in a list ..............eceeceeceeeceeeeee ecu eeeeeeeee 201 
Macintosh sscccinccceciescnacicdicdss sacamsalcessosteasdencced 113 
Getting a shapes page Keys 
from Command CeMNUEF ........... cece ce cece ee ec nese ee eeee 113 LO'USE WIN EVENS wwii ace sassorsewweanassncnseecasnnasstaauss 223 
Gelling lOSts scesgccsesesnnesie sdgerensvoaserecanvartecssonracten 43 Keys to use 
Getting pages in the WOFd PrOCeSSOF.............cecesceceseeeeceeneeesees % 
from the Command Centet.....................cseseeeeee 112 
Getting started Label 
PDIDIE ives’ sascesdnsicniadonwuss domntegangemcecmees wehomosncenooanmenee 3 MAKING COIMTECHIONS ............ec cee eeeeee sees en eeeeneeeees 14 
IBM 5: sie etre sessd aes amedoceGacen nevis vext aretonnd arvecansana ds 3 on the Macintosh ...............ccceeseecececeeecteeesencees 4% 
Ma CintOSh oscsaoseses ava cujenuaaneniaeauas snes dunkoainsdatedess 4 tO Calisé MaShING 025 os0-« sees gewsaees swap ecawesssiareemnueans 46 
GETTOOLS 5. sicosssecscmsetasearmsvccesteonSesnawsauieresoncnsea 221) LABEL command..............cccccccccsssesececeanessceceeeeees 4% 
Global names. icsis.sccciecsiseais svn tininais dees seis nena dame siaine neaivesice TSQ) Label Cuts08 i,j caissisis ceases sais shad d vine cavscuisaaiebedinvadinas coisaiins 14 
Global variables. csscssisecss covasccvcaes esnavna sees covseesaseys 180) LADEL CYS: susscanaars aus iacnevans camsducicvan evitapenaneienseasne B 
GP. secvseusisas ster andvnany vieewesiadtenwranienen taien sags acleahsmromdaionen 112. —_ Label mode 
Grammar MEAV AINE ia sais Suis ciocten mrad cates! verse Ene Setrteineiieansibowstaaanncnes 4 
IMPOFtANCE! OF... siescsicsnceenssncdsedsnsseneosesdnases teres p WHEN) 10 USE ..2 ois scisiascisa sisi vSiasigndcaasasdienisiian an joule 36 
MAKING USCOF weseweed sewn ewwiewassuaen Seceweernew ene eves 80 _—_— Label text 
GREATER? AS QTADNICS os cinss auayrsmaewias vaatune nes aren sertnios soasthons B 
ON the Macintosh...........cccceeeeeseeeeeesneeeceeeeeeeees TQ2! * TEAST cess sican sionieincaiveiniianliinivieiy enievioige’sevisuieciuiabieeiets vatseniaes 195 
Teength Of textisecccs.cccscssscncoccesascncss suesecssdceu seabsouss 174 
HEADING fw osssiocesvivecadusias aie atlasionsd eeiiociyp tapewadueaiwornce 185 LESS? 
Hiding the turtle ..............c cc cecec eee eceee eee eeeeeeeeensees 13 on the MacintOsh ...............ceeeseseceseeeeceneeeseeees 192 
HOME scission vans scavonesenen cxcics evinscatawtasunpacanitewcaweawsss TD -LAStrcwess tsccascesencasciast dza anaxaseeamnanteraamasewases avsiaa 206 
ELT secs virhesressivies eataonmatietennpivaectnnt eax sastestnen eat eas deedeanton 13 and SENTENCE compared.............cscseeseeeeeeeees 206 
MEMS I soe si2k oxic vans tmeosnpaseuneeeiegs sees ance weeeimaainoe 201 
Icon LASt PrOCESSIN Bsa, sii «sia iste anitera esttaluisniints deltaic svi aietnaresice 195 
LOQOWIMER wiiccaies cxea saetciws avns eoresiinsy nah antes time was cos A LIST sencasiaccen tae -arecunaed senoand Redan ankotegnwede ve sncatta 190 
IDENTICAL? scsscctwvsnivniwentenntivenouns actuiaseurannnbeess 189 Lists 
DF icsspimiasweuibiie teeta tetbemes eines gene teloswat/ daie wets sielscispeniu's veelcceiewey 97 OXAMPlES OB vcscisccascouenineheasies wine suds sand sorausdeamereg 8 
CESCTIPtION Of 0... ceeeeeeeeeeceeeececeneeeeeeseeuens PES. TOAD couse ice wclebisicat yaiseiiine snclamibe's wa dbaieiecctoao chiens 108, 111 
OxPlANAatlON OL ssicas scasiaios sves svsarsanraecerssonmeacaee 97, 98 With (OOM sis ses axed aeen aces sand waa cotantan sins teases: 159 
More than One ChOICE.............ceeeceeceseeeeeeeceeeeees TES:  LOADP IC yaccseacastenorenstaticnnans emacaaet mdaxerroannay 113, 226 
multiple commands after.................ceceeeeeeeeeeeeee T16: LOAD VEX ag ssisg sin ceisistisicsa'ccisi'niaiciemien'esing vcalcalesintnics es 113, 226 
tO SLOP LOOPING ............ cc eceeceeeeceeecscescececsesceeees 97 LOCAL 
which statements aFe FUM...........c ee secseeeeseeeeeeees 8 Macintosh 5: nss oa coe snawaatas anes veanamniewes teas oneness 181 
TR ELSE wes evesnsvssnirave uetives cous unvemicain arassleiodocaaeekien’ MUS: Local Wames iieciacscscwissinn see asias sates wees siecle seoteawes tens seecense 179 
multiple commands after................csceecseeeesee eens 116 = Local variables 1.20.0... ....ececesceeeeececcnecescneeeeeeeesenes 179 
Immediate MOde.............ceceeeeecececeeesececeeeeeseeeceseees 42 = LOCALING ASCTEEN 2.0... eee eee cece ec ecececeenceeeneeeaeeeees cf) 
INCREMENEING sia:s css saziscaue sade o20s cos Sencepes snes emis eeweewnws 143. —_ Location 
EXDIANAON:OF sews aesirconedgtas ange stegtineies aaueans Saebamwen 145 OF the title 3 esas saat nanede ssoteanuswdes varotaed eberes peste 47 
in graphics procedures ................csceeseeeeeeeeeeeeee 147 = =—s— Logo punctuation ..... 2.0... see ee eceecececeeecec ence teeeeees 8 
Indefinite lOOp .............ceceeececseecececeeeeseesecsensseeeones 87 
Infinite: lOO PSwciec secon scissceesstesscesszemscnissesxessasenseneess 88 definite 
LAX MOMLOM wesjcossanesscanmnctenas dues iweevans convenes ceeneces 156 ENINCE 0:5 sosmtsus cxesisnus nen orrewisinamcexions 87, 88, 89 
Inputs INGELIN IC sc sisicnecsicciieciatcinniaws sanivsiivesledevenivea vaetvaaincies 87 
Cautions when USING...............0.eceeeeeeeeeeceeeceeees 126 WDE «sate n sd dinccisacseacsanacideaaddasspncebandenecacterse 8&8 
passing values from the keyboard ....................06. 124 ~— Looping 
Passing values USING.............eeeeeeeeceeeerereeeeeee 123 SLOP DING oc. sha wreerworcese naeacirge Sac tewosnice Soles aeeleemeatii 97 
POCO GUIS 2c, aise reseed coats raisin ea rincija djaeinaatnl tai 119 ~—_ Loops 
USED SM OOPS 2 cisis nine stioniattne cain sprdsinasisiyels Scdle Sepntaielaen 122 USING ANPULS oi sve... .wsa cers bssacensscasesue daveuame veers 122 
Index 255 





PUT sisi discs olsicesls sale vaeleinsen danbe tadioeginaneaesatiecoteenatecnes 209 ~—Ss Page 
CHEATING asics sas ssravicaneceed enex eve Sandewkte Sentedeveseastexaneas 113 
Macintosh features COMENS is sssieiseisceenenvinansaiatinwacamewannsiemae gewsennneensawees 3 
Not in Other VerSionS...............eececeeeeeeeeeeceeeeeees 249 MOLINO Wisc isn ovine s seacacead gece'sonegniecdcdieveseeusedeaieuees 8 
Macintosh System..............ccccecessceceeseeeceeeeeee enone 225 PUD SIMC) 5. cis cccna dacs teicncdnsices's sadeldca¥easmsuaiceuita cearet 41 
Malin Procedure « wc5 ossscnes sens ssameteveresssvaess seat svassbacrees 48 flipping 
MAKE, seiiesawssennsssuaswasonenacebestearaumasicuseeesiies sont sen 179 from the Command Centel...............:c2sc000 113 
compared to other languages ................csceceeeeeees 179 NAMING: 5c 5s cidsoseseasoert desanoubee ta yuageyeus onde neg area 6 
CHECL OF USING. 25.6 cscscene dens cous deta cus stea cen etsieen seniees 181 ME Wo: doh sawiensdivicsisnsitomcivnsievsiseaanienesiainnsuaanicemenmuceccen 5 
WiCREALE FAMES 56.3: ssccsviarssasscnas exes seni seawatialewies ere wes 179 getting from the Command Center................. 112 
used in debugging ................csceseseceececeeeeseseees 182 PON ANIM Bess ssis evoaes cies sseamnivana ect egqwarade ondelseoecaey B 
Mate disk ss cscs sccsecccs ceca sc csesascccsdscocsst stcaieiessoacesens 3 ° PAG ELIS Dia i ssccencgacaesiia tidus dencivcdie cid nosuteanguy Uaioe auucs 111 
Mathematics functions Pages 
AN LOG ea ecicsis epes cad cae ynins valve cea maiewens sloosemewssnaes 153 CLASIN Dos tees arco ouisieweytasiaat dusk aba tahesemeuens romeeweees 112 
Middle out programming ................cceecececeeceeeeseeeees 52 getting from the Command Center ................000008 112 
MK DIR i siacsicds. sic conshan sides sss goncenedeneaccsaceeis onsceeaetes 226 WSU OB aon ioc oa viabind sataddcu gecedensiucscuhadeas acaicawkel 111 
Mouse Tracer NAINES OF ssasins cerdeesiesawed cows eweeaisy opccawas cues meee suave 111 
ON the MacintOsh..............cccccccecceseeseseeteeeeees 15 OM? GES Ki ccsscsess cakes tvotsied sabtearcnenleiaenenraee en 111 
Moving text ..............c0e2eeee 61, 62, 63, 64, 65, 66, 67, 68 WOOT ciscerSs Soedd cad octet se natinnerasinnsue lau pew eee eects 221 
1060S: [OF USE ies caatesd. cameceans can nelannes omceeeemns sams eens 64 working with multiple .................cccceeeeeeees 219, 220 
Multiple characters ParaMeler PASSING. .scsss.ce0-seorsssseenvwovscedavecsevereussie 140 
TRACING os cajeractooesingitisnincesietee cacwiecien antes cuaionieceneneetios 8 _— Parentheses 
Multiple decisions.................ccceeeececececeeeeeceeceeeeees 125 for multiple inputs.................c.cecseeceeneeeeeeneeees 103 
MUL pIS WUTC ss cccsscesososnaonsaxenasesnssiwanseongevscsss 73, 129 USING sssicnstive emucceniensnmanadrianes imanavan ey realaasten aes 57 
POUING TID Of. ccsewseegeweamunges seu ering duigetesous ames wee 76 ~—~ PaSSiMY ParAMELeLS .............c cee ececseeseeccuceccecceceeees 140 
WHEN: tO. USC...cccccrsscnsscnerscrecsensssoctessooersscnssenes 76 ‘Passing values 
Multiplication Sign ................ceceeececeececscecececeeeeeees 153 AMONG PFOCEdUIeS ......... 2... ec ecseesescecceeceseseeseees 137 
MUSIC assiscsierte naaeamrtsiasreeseieaisine sinatianls smentiows qeesanieenen aoeewes oO from the keyboard 
Music and animation...............cscceeeeeeececececeeeeeeeeeees 4 USING iNPULS....... eee eeccseeceeeeceeesceeeeeees 124 
USING INPUUS 6. sais soaide cess ecowsinedsssis Sesameionnscarcseee 122 
NAMEPAGE wwsisaessesiewes contanas vans vantvassbcsvestaataexoune G  PASt6iscss seam ied Sowsnaceease sites oie dees aia) Hod odead woes adwoscs ons 167 
Names USINY COMMAMNGG................sccccceeseeceesceceeeceenees 167 
PLOW al ii ocicdounina comcou sve voekarertencmstcndsacauddwenorteed 180) Pasting Shapes: cis ciscicccicinnsesncwovesie sapien seiey deeaweees dieses 65 
LiSt:OF 3s csscncen vcs satc casts snmepes wenn avas aizaetacadsensa estes WSO PASI G feXt iwc cscs sees cas scncsesancaasdsie issacaausaseenerasevaces 61 
LOCA sos carsxwroescansassaatonctnetnuidines velabties wetaeepeeraras DT9:. Paha sn sen cr cowesentievse ced avseosiwesecbecenss sew names 25 
FEMOVANG vee cosvereesisisisgiccinctitis necvnyqediec a redidecoivens MSOF PD ios icesaiicien serntssicchsioteretadiegigocimalgvancweains sees sduseien tedeansanes 8 
Naming PB isso ssctheiiasienin tiara sexs dupuigaadisds Semissioe dived nad alse debau shin satin 9 
PARES «acc icnicsvone snsa sinseeen tides erenions cneemen amd dealer ae 6. Pen Eras se sies sincsweew sce aneis need dona cent aes cans Mae scauatan adds 9 
NEW P@ BC verindeccoestressevaduperssenopsnensies oespepennasebnesmess D PONMEVEISE ac saisecanasresiccmatiuins vnies Sate eeinewrage aden temeworenney 4% 
OMI 6.2 saiastes yee seine Bcsdcioane wade vested ainerlesis'sld dine sie s Bt WBICK stsssiveteaeend sna cistonidade ead naewleateuaic oayins ancg Bias auses 203 
NEWPAG Eros sicscxsasenuinedenadsiepacibsinnednceibelnuinestsneats 112 ~—s— Pics 
NO Tivivcciasscecisensnsinetsoponpanpandetisnond tested tea snes 108, 190 Macintosh only ...............ceceececescececeececerecesees 251 
NOt, CQ UalSsiccscoscsnsvsvsnnsesncecnssssaswccssenaeenteeacesseaves 108 =“ Pictures 
NOt eG lial SIQMs.. scecconeasipocsenattaciiiensscbinis canieiinieslssidaieise' 9 saving Only graphics ...............csceececceeccseeeecsees 113 
Notation BOS avtasz tessievstieks cae anenatnonasnasstaccewacncesoes seilvocnt 47, 184 
MREIX: ss sas sawanwan dee Sannn conswsnitms Sean saies snadenewemneen 196: PHEDICAE sos ss evssnscnszosssemensdennetess 189, 190, 191, 192, 193 
PCT es cictueranesbrons ate attanerecerenietecmney dasniomauineer 156 COLIN ED onicges dasesaiiceeas arewiscenss 189, 190, 191, 192, 193 
Notes Predicates 
FreqUeNnCles OF ai sisi. <cts. sexe censiownones cs ntsueuad nacecovwens @ WIILIN = YOUT OWNL......... cece esseescesseceeesecensceeees 192 
relationships among durations ..................:seseeeees MW. "PREP Xos iis see ccsiesscunwesaicaner ine sale colons ancistacetedanas dniens 227 
NUMBER? ssisinnicowsimsnieoersiigeisisty eisisiciielciinralers uidise simesorinnaleiste 190) =—— Prefix notation ..............ceceecscsscecsenecessecscceseseneees 156 
Numbers BRUNI  vsciadaisinaisnas sicisiswitsiasinaeraa da suse saisis saeseie ate whale mamiord salou 5S 
Of “StUrtleS:..s.é.cccecsccsa.seshnaets den sore mera tnzee means B and INSERT compared.............scsccsessecessececeees 101 
WOPKING WIN vesecais caascons cons sacoions ven cmmnccerenes vases 8 and SHOW compared...........cececccseesessseeeeees 102 
Ont he Tip Side joc; cesiseswinas somssiieiwens caleatemesncmeaartes 108 57 
ONEINE | ioeieis cs seciawsissccicsiesiesiscamncnsnnmalacunacsinienacudduinaciow 226 used for debugging..................cccccceescceesesceeees 126 
Operating System..............cescsssssscecececosenesseseseess 225. PRINT and SHOW 
soueisaienaeewen coterie 4 aueteardeaustar! saeienacens omameeestaose 190 IN: GEDUL GING sacncsersccaecdreinanswuneses teiwepeceeevedes 103 
OUT POL vases eectienaiea stings lease sien ard sears ade caste haves eee 157 _— Print color 
used iN NAMING ..............cececeeeseeeeeceeeeseceeseeeeee 161 Macintosh only ...............cecseeeeeeeeceesceceeceeeeees 251 
256 Index 


Print enlarged 

Macintosh only .............ccececececececececeeeeececeeees 251 
Printer 

CHECKIN Gs siccsssencsnans eecowenacstesseuresseetessmseneeseas 214 
Printing 

differences in different versionsS...................ss00 XD 

GOUDIE SPACING sc ss05 case cesseenaveriiorss ceadaciaawenteanee we % 

FLOM = PTOCEMUTES.......... ce eeceeeece ee enseeeceeeeseeeee eee 55 

OM: (A. PRIMER asiesevvicssoe sees west caedsisccsoremementnyeastoets 9 

OM UNE: “PAPE... cascssivessvescsnivcvsivessesevespoecisesessseesce 55 

PKODIEMS WIENS 5 v0 iis ase desanens cons wes sdaacmea vanes 35, 36 

the PAGS so ccssics wacemtecssoaressmecapes aeuesan ewes deimamecame se 9 
Printing text 

with PRINTSCREEN..............cccccecsseeceeceeeeenees 35 

With PRINTTEXT vosccsescaccsesesssiyteavvssecanesvaenes 35 
PRINTNAMES \incysnasnotoaned tiowcemeiuntarsmerone meeeeee en 180 
PRINTSCREEN os:osasciidinadiscemausanninndssananinidacocoscoararme 9 
PRINT TEXT wisstecsaieatesnacntsenssvaacazavenasetvecss 35, 59, 80 
Procedure 

AS BIKEY, 100 sisrcaigaies «stasis snscssinnieie noicsinei siveinasinisir cower 42 

MAUD ois5cj ckens ca ceckecncadenmedaddemenmsemeeenre ney ace Cotaaase 48 

tOP=1OVEl vss sci sies caters sus ons oes exveneierenseas sooseiewcannes 48 
PROCEMUTE IN DUUS wis sa siienics onwosuearntesemse aveanas sea snseeess 119 
PHOCOMUIE MEE a sia.icsci veins vane eoveniramnmmacmemeivobiwcarcandat bevetesta 48 

Tules for Creating ...........0.sececeeecereesesececerscneeeees 49 
Procedure trees 

TM COOL KilScoicccecsencssesescnscsyenapessivennsersdoecosou sey 161 
Procedures 

adding to existing page................eceseeeeceeeeeeeeees 108 

CALE ROLES OR seven ecusspacncgxouncvests seine eieouewehanwans aneoeee 81 

inserting COMMENLIS.............ececeeececeeeececeeeeeeeeees 48 

more than ONE ...............ceeeeees 45, 46, 47, 48, 49, 50 

TMNGEMSHANGING: scsevcecis cos ens sanwseayaesioemeenneesie seea ces 81 
PrODOS vissce'sitsie's'sesis'sniscsiowsin selec snsinenpenicerewrdinan eine cutetiaidindwi 225 
Programmable keyS.............sscsesesscecesesececsenssesenees 223 
Programming 

DOUOM UD i siasswecttoucnnaas seacauas asleewintea wees yee ipasnes 51 

IMIDGIS: 2OU ii ces cosccosteedcsessvetensesestnng ees ntcetecepaey 52 
Programming Style...............cseceeeececeeceeeeeeeeeeeeeeeees 52 

QUIMCMINES LOGsccss casecccvdswesesasensicssesareseeniecaerees 52 
Programs 

PUBLISHING... spies secsssoaessinesendonss apunrnieiiasioseweneces 52 
PU) isesiicinseisic's sin conics lorocislas ict wistearsicreiines dintslowatow’Sapiestaucise oie Ceres 8 
Punctuation 

LDQ Oe sicpiniesarsittctentesinamacas ecesemes weer enablas sikd cline boasties 8 
PUK iscsi edie bicieslepnteaicbatervavicerS creas sielalvieicd seine eiatsn'o' scien vnttvinielnnle 4% 
QUIT lei acissasnis ansinnnes cena Hens cantons pumbrconnmnnanin antec ones 227 
Quotation mark 

with NAMEPAGE................ccccscccesesseeececeneeeeees 6 
Quote 

COMMON OF etsisiceciwuernaies etad quield sna sauiestene seep sald waxes p 
Quoting 

AN, (EXAMPLES. .icesicsoingesseenseessancocsasecdikdecss wecees 155 
RANDOM: sicsetuicwssnoasearaees ince anes sans tmesnes oqeosweeeaies 18 
Random selection 

from @ WOTd OF LiSt..... ele ee ceeteeeeceeceeeeeeees 203 
RC 

on the Macintosh... ee eeeeeeceeeceeceeeeeeeees 6) 


Index 


explanation Of ................ceeeceeeeeeeeeeecteneeeeees 83, 86 
TUMUUAUIONS ooo oin nes cncincedis veaionie siededieneseninaeansasivcannse’ 6) 
WHEN MOMSE sesesenscusswnamanes anaascus ange sant venwaoias cae 109 
Reading multiple characters ...............ccecececeesseeceeeees 8 
READEIS T o.oo crccssspcetstestsiidsiccastentlontvccieSadsisdisceun ves 106 
WHER 10 USE isiias does ders Snes covdawen posh een cae aes gaeeenre 109 
READLIS TGC os scisctecoiadu vids telgassaveemaneddicdigkiocecseceas st 105 
READWORD 
CTCAU Go vasss dsj ccisisiaisinaic alco dics saersistawsemnasamoneveaaerede 107 
Explanation Oli sss sxcs sae antes ancceaweniwns wens aniew antes outed 157 
WHEN 10 USE was saavocusmsazs sanaaies eaneadien yerennm aexccaes 109 
READWORDCC 
WHEN 1OMUSE wat cass acendosdeamaversceatanes tecrawatetn adios 109 
RECURSION :s:sc05 crocs eoewansis cunts seen sere alee tows aan saeanaee suseeees 8 
Ombedded............s:0scccsesececoscrvensanssrsececesees 89, 149 
fall 52 32 so acewatandoecdsisiedaiosdesis sacaoo@endeuneainarsas ees &8 
Gefinition extended ...............cceceeeeececeeeeeeees 89 
multiple procedures..............ccscsescececeeseeeees 89 
SAND ies ccosdasncdveiceess sasawtia vesieuisstienDaiinineilow'sas’os 8 
Recursive 
DENIC waxcceactaey vetemncvensss aes acndaveesamuivesenamenscs 8 
REMAINDER 65. sissss ccsvvosxcussnseasesvsene seeeuevsosaeeenass 153 
RENAME ie oisisdicniontsinsdu Seinis aciechamienenie ema ansnerni suinbioutcciintge 227 
ReNaMiINg 4. PaVeees sisccccescccecewsiccarraevcrsessmvesen races B 
UT cscs dwieetame sevowekeunceanteatag Iemasiaun nae sence eameme dds 11 
REPLACE oc setsctsny cciesiding saivevcttatstncciie av bavaragty nares val nda slates 172 
Replacing text 
COMIMAN [Oly as scar secacaat same sata dinar ews aaaaevanerarere 172 
Reporter 
MEAINIIONIO eso ays cai dieiasciecuionsntecienseasaurd cision gemlerncuisist 81 
Reporters 
Cartesian 
used in debugging ...............sececscseeceeeeeeees 186 
CICAUNG soc ccensansssasacicanias sos dor adedaancscasheacaensy 157 
RERANDOM. | sscievtsi idesmienaronimarvrenn nies 2 
RESETCOLORS 
ON. Ue: GS ores deicasvessasttsndsucsvacee eerie soenbucesdaacaees 2 
RG 
with multiple turtles .................eeeeeeee eee soilcae ciate Sw ® 
RIGHT ios ipovinarininaseraves aeanaeunenierens eodanduvneiawceacaques 7 
IRMDIR science sieouiwand vgeeauearerurics auniseaieatodsaneennat 227 
RRs. cccacicdvelecpietdsaduceasen acer dean isatedaceaancueeseaiiatieaasnniun 7 
SAVEPIG 5 os sncieisten cae duies astentnsledunisanaraniy ooseeben a 113, 227 
SAVETEXD esse sicsiseiisisiens ciinatonteinevini clea dntsinsinieiclontts eae 113, 227 
Saving 
Braphics! ONL Vcciisecceswewcosecccwosccecesemanensvssedees 113 
PLAN TOPs sctoretsosaaanas siasdermay ce dbayed emenGendd ncaoouet dant % 
possible problems ...............csccseececeesceceeseecesceees 9 
tEXt ONLY soos ssecwens secacews aene evenauae deka see oxen oreveeeex 113 
ScrapbOOk diSkiwscconcscodessccewsineceredes owe wmeestenvcatenees 3 
SCFEEN COOTAINALES........... cece ceesscceceeeccceesceeeeeseees 183 
SEARCH .............0008+ 171, 172, 173, 174, 175, 176, 177 
Problems: With woes 3 sei ssacscncssus iaeacucssaosa cain sins eaves 176 
Searching text 
command for......... 171, 172, 173, 174, 175, 176, 177 
SSMS Ct sc ssc isslde seal ais oiobwinosissio diac datas slwceviuinecteetts esta ve det 167 
USING COMMANGS.............. cc ceeeeeeeeeeeeeeeeeeeeceees 167 
SELECTED \ cadwsnsa cesauies seasneiaronas eeatesin vent oon tea de 171 
and CLIPBOARD ...............cscescsessoecetaesenersnees 173 
257 








Selected text STARTUP 
UINSEME CHING soe ssc ssiaiisaine sis cncinals nasdnied seideimemniewoans 171 AS A PAB MAME.Q..... ee ceeseeeccteessstsececeeeeees 217 
SElOCting: tOXts siccsececcssuvasecss cemnswossaewenecesausesaneeonews 6l AS A PFOCECUIE NAME..............cccccecceeseesesssetsnes 217 
SENTENCE siescswvecenssidennday duawsatenacters tney gallooneotisoinsts 205 USIN Bis sdisazcsanevssiteesesicuntinness aed seeaunennmeemmamenreres 219 
and LIST compared ............sccccscscecsscesesceeesoeee 206 =—-_- Sub procedure.............ececccscccsssccccneeccesececeeaceceeneses 48 
SETDIS Kreis sss oins sieisuisiswisle tienen tein cnsawnasins name anion gauanies 227) =—-—- Supe rprocedures..............2cccecescecccscecesceecececssececes 48 
SETH eves socndvesscxas net ectesie snus wee temt aunt apeag salaceseaneeaens 184 
SET PRE EU Xiios sce sbardamarcascdunnetieavartesaslesymeepweivens'ews 227 RAB? RE Yivssesossvosyssheuctotuadis aomedhooapsenouienions wevsenaes 35 
SETS Hoe osids soviee nd hovetvetaiaercana cetewediels ecictalculesharweraelsh ae none 21, Tail. TECUISION. ...05.02esccnssesnsacesssecvesconscessesescenenenysy 88 
SETSLOT szss cosisesnctexcauisis shea sank once jdcns Soahdets dagmnes abe 27 TC 
SETTC ON Whe GS ise sevscseesscvescrzcecdewessaeianesvasitienessts 37 
OO the GS eg sca sssneaiie soemsupe ets meaeesieecnemeatceeeaeuentees ST TS yc cvevcoriccsewsais cencegnaataacueaneracs viae qnanasess 73, 129 
SETTEXTPOS ois cisccised asia steawaninddanscnale Saeels oibieiyecesmserss 175 CHE OF ois gas iindncsiisuie' sattsiears andananiaesbendesoreieet seats vs) 
SHADE EXDIANANION sosee0 cases socenvraad sass sind wed ated wees ynndeneneees 135 
Problems With................cecseeecenceesceceenssceeeeues 31 WHEN 10 USC cn arcsnas gues ocnvanquiedexsundiseanbenntstesusins 135 
SNAPS seas isos taney cde Gaedaneae’oaucionsts deed acanceines 25, 26,27 Text 
COPYING ios essexsevccdscosancevdewwecacduee seve sedesadseaxeaes 65 CLEANING: i senccixncctnsctaasbicsss ossesinnd cnsnescostieseedou dine ¥ 
creating COPYING: cadscnesdoncdsnsenaeiies veas amex esanowes mvkadeen dees 61 
ADDO scessscctancercsnas dansaesuaetxtutceceie Meeeseeeence 25 CUCU Bi ccoscicenwetsicwious ccdnaseeastewie oho eds ae aoe 61 
TBM, scvsascasoteasiesiies aude cndaciepaiasuslansedon sieves 25 MENG OF 5). seecdsicannaisndsnsesaumsaanchron souweare chien dene’ 174 
CUTLINE i sis cwannvesvonacews cans vate aeaacousaupvanes ens ansa ca 65 OO MNE Pate snses cieaiensdwins Sasa seiadianwraacindadernseons 33, 34 
DASHING: swe acasdcraveis ah mewars gece low alles andewateesattewetaes 65 DASHING ics ceiseravesnaes aaremauieen teen Bek Meek oes ans Bek 61 
TORBUING o.oo d:pwissicsisis c'oarsisiercas sa siclgwiig Berinatieninniclvcttnasieaminnas 2 TOPIACING ois ininwioniensiniase sass dajen wene were ends aooaemaeinns 172 
Shapes editing tool SAVING OMly teXt...... eee eceecesececececereeseneeeees 113 
On the. Macintosh swiscccssccccncassccscweessvekvecsaevaseves 2% searching ............. 171, 172, 173, 174, 175, 176, 177 
SHAPES. PAVE cersciwessvsseediesdesnsansnwessten veeexearquacenaseilers 21 SCE CHING cscosancsacna Sddanss aacsouaestennenaiinonarnie weenie 61 
Blip: ‘Side icssceeccoseccscuescen cases tanvsesiindssiensiieiisisiensa 2 WOE PIOCeSSEM is cccesinnveniswannncrieeesivedye waesvev anne 4A 
getting Text and graphics 
from Command Center ..............csceceeeeeeeeees 113 ON the SAME PAE .........ececececscssseseececseceeceeeeeees x9 
RESUOP ID Bivcasoncisacowssncsmrersernens naradeninueyeteceseedses 27 ~~‘ Text in the Command Center 
STOW sevens sisisiesie wate oiqeu srtcrsiutentesacin oxipinlaiceie wa Soe or.cheie novaiietooiin 102 COPY De sssic schesesiviajnanistsiectousinclacenedenetresvenmaneseatn 6 
and PRINT compared..............ccsceesceceeeeveeeeees 103 ~—- Text on the flip side 
SHOW and PRINT COPYING esersieses sarsisnnen sedanpetisamnsuinan eens aumastnastasagteme Q 
IN. CODURRING.. cc ccessscveccaveonsesqecsensesencecenereess AOS, “TEAK TILE orc cccienicsnccatecia snieseressains vee yeirsisies anaeww sesuenaeal 174 
SHOW and TYPE TEXT POS ws sioseis saceicee txts swisasasanancsens acnnssavses svtanaee de 174 
COMBINE cose sncesaianisos eaiee does Seep twa idelbnicdentnas ieee 103! “THON wissen icncisasteisctetcda sepia tems taets dates dunes sane andudany @ 
Showing the turtle... cece ceseeseeceeeeeeeeeeeeees 13. _—s- Tool kits 
SHOWNAMES  .....00::008- snsnsssistece edinvediion $033 3g snah sans 180 Co 7 | ee 158 
SIN iss soreecauensveaaweredans ceqed aoed ites coms ames aieeeneeaes ademas 153 IN) ‘PROCCGUIC. IWCS ses cessccescevecietareeeasersieiciniaines 161 
SE OT resssesvssreaerbiadeoapebee sean saatanas tein opars epresinnnaepeiiens 221° TOON PAGES ede sic menccniae nage ese iipeedaciauetaonien owawenta 20 221 
SLOWTURTLE TOORLIS Ds ovate acces aciearsciia'viteansense soon eagte sauanrees pees sean ee 221 
ON the MacintOsh...............ccsccccceresssesesceeeeeeeees DY: “TOR 225s seissiosisainie ds daiciinictisia crea crnsainiionisn aa-cbietcinemeediareaiaienes oi 163 
SOD ose sce cin de cabenbvoieite cace sas sanmoasadataaateaaecareniacndts 165} —s Top-level procedure .................cccecccesececececerseeseeees 48 
EXPLAIN dies coceracssscieonascsnupumnecsoncpmsesvasserreacdes 165 TOUCHING? 
Sound on the Macintosh ...............ceceeceeseeseeceeceseeeeees 135 
Macintosh only..............ceececeeeceeceeeeceeeeeseeeeees 251 Turtle 
Sound effects drawing With.................cceceeeeee 7,9, 15, 18, 19, 20 
Dsinig TONE ssvssses sezenescis cucuapes eves teteammesnes ape inee n MIMD s-s.'cissinconabinabiorsined exbinawielistens saahanrenteatimevantiees B 
Space MOCAMOM OF 6 5cic sis wiccanginnss vans Vey ssonouaee searegsonas ts 184 
Character fF 2svasssssicscscescossecncsvessicescus donc ten’ tee % setting the direction Of ...............sceccecececesseeseees 184 
SPACES wii ancnssenecacseame anaes seas sana dums sangeusiensereemnmeancens an 9 SHOWIN 8 vos: dctirosaussstedatater eneeesnoess wean aadianes tors exeeeet B 
ASOT Bein ts es steecw cine couee dren eden dyonmanngergseeeteuntice % ‘Turtle move 
tool procedure for inserting.................ceeceeseees 57 WAVING aos se Sane thice Sally teins gaurotie t sndaNial seas ainenlaiwen eds 1b) 
Square brackets DOME: NUMDENS 5 ssesiiec 2 seces oeeeicas seudinns edingnaucenetsesn ede B 
WHEN 10 USEs ccc seceersderens sxeeeacenniuansoscametaesnsees 15‘ Turtle shape 
SSPACE . ce testecin ines Sati seen wen vecee seen cemieneongs dene ease 9 CHANGING 505,50 eeriosnn arse scnanaeuane clele debauns tebe cewedar 21 
ST wossnenevatty sap esaptecbarmak cuuye gece elma conn vend uainietiseiqarea eueeten 13 GiSaPPCALiNG........... ec eecsecsescsecceceesceecceecenecees a 
Stamping shapes EASING cs scot crane sae seb sored Vises dasa sige eas eabeaneeets a 
Problems With... .........0-tetsnscedssens csermeassansaness 2B PU iraancccekntigidlavintss ne dteikonn tena eeuiok 2 
StEPS-1O [OMOW sscvcssaica meisemasceas vovenipanewseeses exeeeene 2B SOMME i siaisacen cise ccersesaiccras ya telasrsraie teeeneuions dean amnabes 21 
Stale Of UNG vosesssagics Se wietesoet Gouetvenpintun case ereenesdiienes 165 _—‘ Turtle speed 
Start of paragraph .............ccccceseeceee sense eeeeseeeeseee ees 165 on the Macintosh ...............ccc cesses eeeeeeee eee eeeeees 2 
258 Index 





Turtles Variables 
location ON the SCTEEN.............. ccc eeeeeeceeeeeeseeeeee rr) DUOD IA sce sien seve ulate tes voisvisn dstceens'das vie upualgees ieee 180 
MOTE THAN ONE! sa.s-2 secon chac oesinsddaieivad ogecuonedeeaeaves B MaGall io 3s id sise a said Sept cissisinecn odavnleiwndcasleneawoeancdiewssen 179 
MUL PlOsescsncendicoasacens eve cocees seeewsteesameaestinnaaiacs ss 129 
TYPE ecuwewsonewoxnres tivek vombseni ved steeeweneanitortdtoaureees dee 102, “WHEN Wessesisiscnissdecswaawosintoces aaes aniiacasidessanestewnaes 223 
and INSERT compared ..............csceceeeeeeeeeeoeeees 102 Keys tO use With ............ ccc cc cecececececeeeceeeeeeaees 223 
TYPE and SHOW WHO isssissitdinn Seas ccs sGntiedicie shcintiad wien dean scunmaainancone 76, 129 
COMDINEM sda ssn dass adwasemn aca cneuewiean sess Semaomeianew 103 WINDOW sices seecescsavs danieewes eas sous nactay aareiniiensaes 
WORD oicsvesecesidiusies ates qusiaokne neseuatetys nearcadenvan reser 205 
VND vise siiceise cadeesd od ieibsiguansooraaeiacecantotosetes 37,40 on the Macintosh ................cccssceeeeeescsceseseeeee 207 
UNSELECT oo ccdcscsinnssccisittnsiceitctecleiianetdeacntsiddsanhesioee 171 WOIG “WIAD ic isessedeccesccatevasasasacesscscochaees caieaesacocers 4 
Up Arrow WORD) vcsssicsvoninasiasaiemapsestwaaanind vetial oa NS 190 
to repeat COMMAMNAS ........... 2... ceeeee nese ee eeesceeeeeeees 7 WRAP 
Using PRINT to debug ..............cccsececeenectceeceeseoeees 4 on the Macintosh ...............cccccesscecsecseeenseneoeee B 
Using tail recursion ................csceceeeeececeeececeeeeeenes 88 WE aD PING si Sasnisesks suis ustincies Seem ansd teen ales Sask aan TOR 11 
Values MCOR vic re ssoateases eo dcteresewe nates nasser tuansaeteaed 186 
KESPING oF ssatissusoeathcaalvctas vacdcnshaaasanmneenconsa cyanea 137 
YOOR cisiceteeanaesauienisteras aires dnwatandes oeedaisonsvmmmans 186 
Index 259 





ISTE BRINGS THE WORLD OF 
TECHNOLOGY CLOSER TO YOU. 


By drawing from the resources of committed professionals 
worldwide, ISTE provides support that helps educators like 
yourself prepare for the future of education. 


ISTE members benefit from the wide variety of publications, 
specialized courseware, and professional organizations 
available to them. 


They also can enjoy exciting conferences, global peer network- 
ing, and mind-expanding independent study courses. 


So if you’re interested in the education of tomorrow, 
call us today at 800/336-5191. 


International Society for Technology in Education 


CompuServe: 70014,2117 
Internet: ISTE@Oregon.uoregon.edu 
GTE: ISTE.office 


WE’LL PUT YOU IN TOUCH WITH THE WORLD. 


= 
g 





